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SUBJECT ! y£MIO-£Ii3££l}yE£l«!IQI£iOfili.l20£yMiiIMIi31i 

The Build H update of the Integration Procedures Notebook *, 

is now avail able* Change pages may be obtained through the ! 

following command sequences I 

ATTACH#CHGRAG£/UN«D€V1 J 

S€S*PRINT CHGFAGE I 

Some parts of the document are now out of date <see I 

OocuR^ent Deficiencies below) but have not yet been removed. • 

However, a complete listing of the document can be obtained I 

through the following coffiirand sequence! I 

ATTACH, IPNDOC /UN «DE VI 
SES. PRINT IPNOOC 

Some highlights of this revision are as follows* 

C£iMfiS-B^llJiilffl£Ci«£flli£i£S* Section 2*3 has been updated 
to reflect how the Integration catalogs are managed for 
parallel builds* 

U&a ££fi££iJMJ:£S* Sections 2*A*5, 2*5*2# and all of Section 

2*11 have been updated to describe the new procedures NVEBLD, 
NVEREP, GET, SAVE, and NVEMAP* 

y£i3al£i3 A££££liJi££5' Appendix G now contains CYBIL 

installation Information for version 81188* Appendix E 
contains the Build N Helpful Hints document* 

OfifiillfiHi y^flfiiJEnfiifii* Appendices C, D and E are outdated 

and should not be used* Information formerly in Appendix H is 
now In Appendix E and Appendix H should no longer be 
referenced* This document will be completely revised for 
Build C* Your coffn^ents for that revision will be 

apor e ci a ted* 
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* Subject and yerb always has to agree* 

* Being bad grafnipar> the writer will not yse dangling 
participles* 

^ Parailel construction with coordinate conjunctions is net 
only an aid to clarity but also is the mark of a good writer. 

* Do not use a foreign term when there is an ade<?uate 
€ n g I i sh j.Misi-.££.fi-.aU.£A- 

* If you roust use a foreign term* it is ii£_£jgjiaL to use it 
cor recti y« 

* It behooves the writer to avoid archaic expressions* 

* Do not use hyperbole! not one writer in a million can use 
it effectively* 

* Avoid cliches like the plague* 

* Hixed metaphors are a pain In the neck and ought to be 
thrown out the window* 

* In scholar y writing* ^QBlX ^se contractions* 

* A truly good writer is always especially careful to 
practically eliminate the too-freguent use of adverbs* 

* Use a coffiffia before nonrestr I ct i ve clauses which are a 
continion source of difficulty* 

* Placing a comma between subject and predicatet is not 
correct* 

* Parenthetical words however should be enclosed in 

c nun a s « 

* Consult the dictionary frequently to avoid mispelllng* 



Reprinted froir the IfiiJl^^afiMilSiiSC— Ifit—HfiMfiJi 
IS£j3BMfii31 (Volume 5* Number 9* 1978) 
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1,0 MOS/VE SYSTEM OVERVIFW 

1*0 muit^imgn^QMEMitu 



1*1 itiisosiiaiQti 

The basic cofuponents of NOS/VE Include the folfowings 

A Hard^ars In i t i a M zst i on Verification Sequencer 

CHIVS) component 
~ Modifications to standard A170 NOS system components 
- A170 HOS application prograins (and procedure files) 

«hich execute in the A170 NOS IReal State) 

environment* and provide systeni to system 

communication facilities* 

The Virtual Environment code which is responsible for 

the execution of tasks in Native Hode In the Virtual 

State of the hardware. 



The nomenclature used to descr 
rather confusing. Frequently* the Vi 
what Is referred to as "NOS/VE". 
supporting utilities are present* the 
used. To differentiate the two ex ecu 
the terms "Native Mode*** "Virtual Hod 
are used to describe the execution o 
terms "Real State" and "NOS" are 
execution of C17C instructions. 

The model which is often used to d 
NOS/VE in Dual State mode is that of 
another* and communication between th 
over a communications link. From 
view* another perspective Is used* 
software* the NOS system is merely 
executing in the Virtual State envelo 
microcode translation of the C 
"Invisible" to both the NGS and NOS/V 
of the Virtual State is merely that 
control point* and is communlcat 
K~dlsplay. The remainder of this sec 
NOS/VE with regard to its components. 



ibe NOS/VE components is 

rtual system software is 

When A170 NOS and the 
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tlon modes of the machine 
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l,Xa TH€ HIVS COHPONENT 

Included in the diagnostic world* which establishes the 
initial Virtual Execution envi ronnnentf is the aiicrocode for 
the CPU fis well as a Native Hode monitor-like prograia called 
the Error Interface {EI)» The flf?icrocode is strictly supported 
by the diagnostic organizations* and neither the NOS nor the 
NOS/VE software will execute without inlcrocode present in the 
CPU* The €1 program Is supported by Advanced Systems 
Development* There are currently two versions of EI* one 
which only supports A170 NOS and does tasks such as CMU 
instruction emulation* and one which also supports the 
switching between the NOS and HOS/VE CPU monitors. This 
latter version of EI requires a partner interinedi ary called 
♦»EIE** which is statically loaded with the Virtual State 
software* and is loaded during deadstart of NOS/Vi» In order 
to assure that the right version of EI is present* the HIVS 
tape which is distributed by Advanced Systems Integration for 
use with NOS/V€ is the correct version to install* The 
version of fnlcrocode present on this HIVS tape will hopefully 
be the right version* but we have not discovered the necessary 
utilities to replace versions of microcode on a HIVS tape from 
an installed configuration such as that in which we test 
systems* 



1*1.2 A170 NOS HQOIFICATIONS 

The jrcd if Icat ions required to support a Dual State 
execution environment are primarily assembled In the Bt0170 
procedure file* Few specifics will be given here other than 
to state that half a dozen Peripheral Processor routines are 
involved* as well as »i50d i f i cat i on to NOS CPU Monitor* The key 
aspect to note about these components is that a special 
version of A 170 NOS deadstart tape fnust be used* Again* this 
deadstart tape version Is supplied by the Advanced SysteiRs 
Integration project* There are additional procedure files 
which must also be present on this special deadstart tape* 
which are not docuinented here at this time* 



1*1.3 A170 NOS APPLICATIONS 

A portion of the software alluded to as A170 NOS 
modifications could be classified as A170 NOS Applications. 
The applications referred to* however* are not present on the 
deadstart tape* but exist as permanent files which are invoked 
or processed by procedure files present on the deadstart 
tape* In the strict sense of the word* those utilities which 
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are not execution order dependent or re<?uire system residence 
are placed on the deadstart tape* Utilities which must be rur^ 
In a given sequence land possibly as system origin) are 
governed by procedure files i^hich are present on the deadstart 
tape* 



1*1*4 THE VIRTUAL STATE COMPONENT 
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mentioned thus far have been the statically 
Monitor* Task Services* the CITOII utility* 
Iy linked modules from OSLIB. There are 
n OSLIB* some of which are necessary for 
ecution of user tasks. Such a library Is 
ns the Object Code Utility modules which 
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provide for the creation of II object text libraries* The 
SYSLIB library must be ma6e part of a job's object library 
list If any II object library manipulations are to be »ad€« 
From the compiler perspectlye* the run-time libraries CYBIIIB* 
HATHLIB» FRTL* etc* must be created by a job which has SYSLI8 
as part of its object library list. The compiler generated 
object text for a compiler such as CY6IL names the appropriate 
run-time library In the object text records Ceg, CYBILIB). 
Thys# a CYBIL program must access the appropriate run-time 
library CCY8IIIB) and make this library part of the job's 
object library list. This explicit manipulation of a job's 
object library list will eventually be replaced by job 
prologues which are created during accounting and validation 
and/or user prologues which establish a job's execution 
envi ronment* 



1 * 2 MI£IU4L-iUI£-£4EIIIiDtiIli£ 

The system can be thought of as being divided into three 
partitions which consist of six object text files. Each 
partition has associated with it certain protection* privilege 
and responsibility* The first partition consists of those 
routines that run in monitor mode and is known as the 
monitor. The second partition consists of those routines that 
run in job mode and is known as task services. The modules on 
file XlMflTR make up the monitor* and the modules on files 
XLJllE* XIJ12F, XiJ13F and XLJIFF make up task services. The 
modules on file XIJB8B consist of user tasks which can be 
thought of as belonging to a third type of partition. This 
latter partition contains routines which run In job mode In 
the user ring Cfor the purpose of converting CI compiler 
generated output into II format after it has been transferred 
from the A170 NQS software to the NOS/VE execution 
environment). In the memory map* which is described In a 
subsequent section* the code for this user partition resides 
in the "User Task(s) Library" and is made a part of each task 
created for NOS/VE, The system restructure which occurred 
with Build H made this partition relatively small (since this 
partition must be loaded into memory at deadstart time). 
Although the build procedures allow for this partition to be 
replaced with one which contains additional user tasks* the 
preferred method of executing user tasks is to GET them from a 
NOS permanent file (after they have been generated by a CI 
compiler) to the NOS/VE execution environment and EXECUTE 
these tasks using the NOS/VE LOADER. If the execution 
environment is the simulator instead of the hardware* then new 
user tasks should be statically loaded in place of XLjBBB 
using the NVELINK procedure. 
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Any XDCt«d symbol within a given partition can be XREF'd by 
any wodyle within the same partition. To allow other 
partitions to XREF these same syisbolSf the symbols must be 
gated. Gating a syisbol only makes the symbol available to 
other partitions during the linking process* It does net 
necessarily mean that the XOCL'd location can actually be 
referenced - that Is controlled by the ring brackets. In 
genersif only selected XDCi'd symbols are gated, A variable 
or entry point may be gated In the source specification using 
CY8IL and CPU ASSEHBIER language constructs* or the object 
text may be modified by using the SES Object Code Utilities, 
Refer tc the HAI><offset>K file* produced by theNVELINK 
procedure* for a list of the entry points available to a user 
task. This list of entry points preceeds the linkage of file 
XLJ868 and is entitled "INBOARD SYHBOL TABLE ENTRY POINTS FROH 
FILE I STSXOST", It should also be noted that a similar list 
exists for the Monitor entry points available to Task Services 
and is entitled similarly with the substitution of MTRXOST for 
STSXOST in the above title. 

Occasions arise In which procedures are of common utility 
to more than one partition* but should not be gated across 
partitions. In such instances* these procedures are placed 
upon a wrun-tlme" library such as CY8ILIB* and references to 
these procedures are satisfied at "LOAD** time from the 
appropriate library, "LOAD" time satisfying of externals can 
either be done statically or dynamically, A static load Is 
accomplished through the SES Linker and Loader utilities. 
Dynamic loads occur through the use of the NOS/VE loader 
during the execution of a C180 job, Whenever possible* 
dynamic loading of routines Is preferred (as In the case of a 
compiler satisfying externals from a run-time library) since 
this Is the mechanism which customers of NOS/VE systems will 
be us Ing, 



1 . 3 l2iilI£iiiAIifiM-Q£.l:lQi£)^£.£AaiIIIQtlS-Ma.LiaSASlIl 

When building a systej^* monitor must be linked first. All 
gated symbols within monitor then become available to task 
services* which Is linked second. Although some monitor 
symbols can be referenced by task services* the only way to 
execute monitor code is via the exchange jump - i,e,* the 
CALL/RETURN mechanism Is not valid for use between monitor and 
job modes. User tasks are linked last and can reference gated 
symbols defined in task services. It is important to note 
that although the linker will allow a reference to a given 
symbol* the ability to actually reference the location is 
determined by the ring brackets on both ends of the 
refer ence. 
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1 . 4 filIA.E£liS£M£I£LiE£Iia£.JM£J}-flM-£MIIIlfii 



The following rules apply to static data defined by modules 
in ffioiiitcr or task services? 

1) Only fliodules within monitor may declare static data that Is 
iTiainfrsme *^ired. 

2) Only fpoduies within ring 1 task services may declare static 
data that is niainfraflie paged* 

3) Only «3odules *jlthin ring 2 task services may declare static 
data that is in the Job fixed segment. No wodules way 
declare data in job pagable until the new system generator 
is aval I ab I e* 

4) Only fl^odules within ring 3 task services may declare static 
data that is in the task private segment. 

5) Rules 1 through 5 also mean that all static data for a 
nsodule In a given partition will reside as specified. 

6) Static data for modules that run in the ring of the caller 
(XLJIFF) must be read only when executing above ring 3. 



1 . 5 ailiL-SIAI£.tl£^iQ£X.ai£ 

When dealing with a virtual memory system it is often 
necessary to understand the real memory aspects of the 



software which is present in the machine. The following map 
describes the real memory aspects of the software* and where 
It is mapped during the deadstart process* To make this map 
complete would require overlaying it with segment and page 
boundaries. Rather than attempt to produce this overlaying 
effect* suffice It to say that (by convention} the boundaries 
described in this map occur at even page boundaries. Whether 
or not the pages which constitute any given area in the map 
are paged is a function of the attributes of the segment to 
which the area belongs. 

The real utility of this map is In showing the relationship 
of values which are supplied to the SES Virtual Environment 
Generator through the skeleton VELDCH file. This skeleton is 
dynamically edited when the NVELINK procedure Is invoked to 
produce the LDR<offs€t>K file. The VEIOCM variables are 
underlined in the relationships described after the map. By 
using the rel at I onshi ps glven» it is possible to compute the 
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relative starting locations of different areas within a NOS/VE 
dump* 

It should be noted that the 
expressed in decimal byte 
addresses are hexadecimal* To 



relationships given here are 

addresses^ while the machine 

pursue hexadecimal addresses 



requires a copy of the HAP<offsst>K file* Specifically* the 
load addresses for Bonltor* Task Services* etc* are contained 
in the Virtual Environisent Generator output which iiaflied i a te ly 
follows the LINKER output. 
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■»■< — Hachine Address Czero) 



A170 NOS Operating 
Systeii 



4 ^. . 4 < — H a X i IS u BJ NOS Memory Address 

NOS Page Table# Elf 
and EIE 
^ .^. — — ^. 4< — Load Offset 

HQS/VE Page Table 



4-^ «4< — Virtual Load Address 

NOS/VE Hon i tor 



-+ 



; Task Services 



+ ' — + 

Library Directory 



4 , 4 



User Task(s) Library 



4 4<— NOS/VE Length 



CAvailable Memory! 



+< — Machine Highest Memory Address 
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Page Size « C 1 1 ?i 4? 8S 161 321 64 3 * 1024 

Page Table Size « C 4J 85 162 321 641 1285 2561 512J 1024 3 ♦ 1024 

Page Table Length « MAX IHUH (<Page Si2e>f<Page Table Size>) 

« £ILM 

EI Length « 8 ♦ 1024 

« 8192 

Load Offset « C 256J 128! 64 J 1 * 1024 * 8 

« C 2048J 1C24I 5125 3 * 1024 

Maximuir NOS nemory Address « L0AGO££i£IM - £Ii£M£ia 

- MQii£l^£Iii}^ 

Virtual Load Address « iCMQ££i£I^ ^ £IU 

Page Table Address « iQMQ££l£II <8y convention) 

» £IA^ 
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HOS/VE Program Interface ERS 

SES User »s Handbook 

CYBER 18C System Interface Standard 

Simulated NOS/VE Program Interfaces 

VEGEN ERS 

VELINK ERS 

CY8IL Language Specification 

CYBER 18G CPU CI Assembler ERS 

CYBER 180 Simulator ERS 

SeS Procedure Writers Guide 

CYBER 18C Object Code Utilities ERS 

Source Code Uti I i ty ERS 
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2*2 iliMiMM 

In order to facilitate the Instalistion process* certain 
standards will have to tse set and adhered to by all members of 
the Operating System and Product Set. These standards will 
cover the following items J 

a) All program libraries will have the same forisatf this 
will be defined by (T8DI# 

b) All output tapes will conform to soroe predetermined 
format in terms of numbers of files and what each file 
will contain. This will be defined by <TBD). 

c) The above forniats are intended to facilitate 
establishment of procedural i zed installation decks* 
This iffipi ies that some convenient naming conventions 
fl!ust be observed. These conventions will be defined 
by CT8D). 



2 . 3 tIiIlLJ0£«!!iMiMH£MI«£J3iI£i£5 

The Integration project builds two systems in parallel and 
manages two catalogs for each system. The primary system is 
the system that is between the beginning of the build cycle 
and the feature code cutoff* The secondary system is between 
the feature code cutoff and the end of the build cycle. 
Primary system files begin in the INTl catalog and move to the 
INT2 catalog after the system has passed Confidence Testing. 
After a system has reached its feature code cutoff# a 
stabilized feature build is moved to the DEVI catalog^ the 
build from INT2 is moved to 0EV2# and this system is new 
considered the secondary system. Also at this time* a new 
primary system is started in the INTl catalog by adding its 
planned feature code to the previous primary system. When a 
build has completed its integration cycle* the final build for 
that cycle Is moved to the RELl catalog* It Is at this time 
that a build is considered a candidate for transmittal to 
other facilities for further development work* a final Build 
Content Report is distributed and whatever usage documentation 
that is available is distributed. 
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2*0 OVERVIEW OF INTEGRATION PROCESS 
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The following diagram illustrates the function of each J 

catalogs 

^ — ^^, — , . — . — 4. -«.+ , , + — , , ^^, — -., — + 

I • Primary System I Secondary System S Transmitted Systea* 

} Working Catalog ? INTl J DEVI I ™ J 

+ „ , . 4. _ , 4. . «_. — . 4. . — . , .^. — ^ — 4. 

\ latest Stable *, INT2 ! DEV2 J REil ! 

I Bui Id Catalog J J J J 

^ . , — . = 4.^, — , — . 4. . , , — , — _, 4. , ^^ — . — «»« 4. 



In generals pr ocedures executing from a given catalog 
access only those files Mhlch have the same level of 
verification associated with theai* The INTl and INT2 catalogs 
will access the iiiost recent coropilers* SES tools* etc. while 
the DEVI and 0EV2 catalogs access a previous* more stable 
I eve I of yti I i tl es» 

The RELl catalog represents the "frozen** catalog for which 
changes are no longer being accepted Ctypically a snapshot of 
the last build cycle). This is generally the system that is 
being run in SVL closed shop and is retained for duplicating 
problems found there. The RELl catalog will change no n?ore 
frequently than once for each build cycle. The INT2 and 0EV2 
catalogs contain the latest stable builds (i»e» the builds 
have passed Confidence Testing) for the primary and secondary 
systems* respectively. The INTl and DEVI catalogs* however* 
are "working catalogs" for the debug of new system fixes* new 
procedures* etc* The stability of these catalogs cannot be 
predicted. 



2 . 4 iiJIiI^-.££D££l^il££-I}I5££l£IlQtlS 

In order to understand the procedure descriptions which 
follow* something should be said as to the sequence in which 
these procedures are used to generate systems. The following 
is an attempt to accomplish this? 



2.4.1 INTRODUCTION 



The command language procedures 
builds all reside in the INTl* 
depending upon the desired level of 
has attained* It is assumed 
verification is the minimum level 



corresponding to NOS/VE 

INT2* or DEVI catalogs 

verification the system 

that the DEVI level of 

of system verification 



required by most users* therefore the DEVI catalog is 
frequently referenced in the remainder of this section. To 
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obtaifi a listing of the complete set of cofflffland language 
procedures provided in the Integration catalog^ execute ttie 
following command language sequences 

SES.LISTHEH B«PROCLIB UN«<Integrat i on^Catal og> 

Before running the build procedures as batch jobs* a check 
must be made to insure that the user number under which the 
job will run has sufficient validation lisRits for the job to 
execute. The minimum values for certain limits must be as 
f I lowsi 

CM » 2437B 

HF = unl i m i ted 

MS « unl Imlted 

OS « 4096 

EC « 2008 Cif simulator is to use LCM) 

DB * unlimited (each library is built via batch job) 

The current values may be obtained with the LIHITS control 
statement. If they are not large enough* have the operations 
staff change them. 



2.4.2 INVOKING THE PROCEDURES 



The procedures described below are documented zb 
"SES. <Pr ocedur e_Name>'*. In actualltyt to Invoke the 
procedures in this manner assumes that there is a file named 
^PROFILE* in the current catalog which names the Integration 
catalog to search for the procedure (via the 'SEARCH* 
directive). The alternative mechanism for invoking these 
procedures is to code the procedure call as? 
"SES* <Int€gr at I on_C ata I og>.<Procedure_Name>". Many of the 
procedures use the «PRCUNAM' value for subst i tutabi e user 
namesf meaning that the catalog in which the procedure Is 
found Is the catalog which is searched for files. This is as 
It should be* since each of the Integration catalogs contains 
a different version of the system. 

All of the procedures described In this document have 
**HELP" documentation associated with them. Use the 

SES*< Integrat i on_Catalog>f HELP.<Procedure.Name> call to have 
procedure documentation printed at your terminal* 

Practically all of the procedures described in this 

document are written to execute in "BATCH" as well as local 

mode. In order to provide a consistent result when these 
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procedures are run^ it is fiecessary to save ipany of tt»e 
generated files as permanent files. While some purists see 
this as •'catalog polutlon»*# we make all attempts to preserve 
only those files which are necessary for future reference or 
usage. Idhenever possible local file names generated by the 
procedure are given unique narwes so as not to conflict with 
any user files. In numerous Instances* convenient "•reserved" 
file names are used to enhance the configurability of these 
procedures. For example* all files accessed by the procedures 
are searched for first as local files* then as permanent files 
in the catalog In which the procedure Is executing* then 
(optionally) in the catalog specified by the 'AREA* para«ieter 
value* and finally in the catalog in which the procedure was 
found. Thus* if the name of a tool accessed by the procedures 
is known# several versions of this tool can be tried through 
iterative executions of the procedures without requiring 
procedure modification. To aid in the isolation of tools 
accessed fey the procedures a "common deck" type structure Is 
included in the procedure libraries which names many of the 
tools to be accessed by the procedures. These structures 
exist SiS records on the procedure library which are INClUOFd 
Into the relevant procedure file. Initially we have 
partitioned these tools into the records •TQOLALL'^ •TO0L170«* 
and »T0OL180». Experience has shown this par t i t i t ion ing to be 
somewhat combersome for some of the procedures* and will 
probably be fine-tuned in subsequent revisions of the 
procedure library. 

Some of the procedures contained on the procedure libraries 
change very frequently due to changes in system structure or 
for other reasons. It is inevitable that errors creep into 
the procedures at times. Often it is quicker to change the 
KCL generated as a result of invoking the S^S procedure than 
to change the procedure library. The SES processor may be 
invoked via the SES*TEST.<Procedur e^Name> mechanism and the 
resultant KCL is written to a file named SESTEST. This 
SESTEST file may then be edited* and the offending control 
statement corrected. A subsequent CALl»SESTEST statement may 
then be used to execute the corrected KCL. Vihile we do not 
necessarily condone this approach to fixing procedure files we 
can hardly deny its existence. If* for example* it should 
prove necessary to provide our customers with installation 
procedures for software which we generate with SES procedures* 
it would be our intent to ship the SES generated KCL 
statements rather than the SES procedure and a copy of the SES 
processor. 
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2*4.3 CURRENT PACKAGING OF NOS/VE SOURCE 



There are two execution modes of NOS/VE which are referred 
to as the *»st and alone'* nsode and the ••dual-state" mode* All of 
the NOS/VE source modules >«hlch execute in the CY180 Virtual 
State are contained on a program library named «NQSVEPL«« The 
program interfaces to the Virtual State system^ those 
described in the NOS/VE Prograw Interface ERS* exist as comison 
decks on a program library named 'OSiPI*. The content of 
these two program libraries is referred to as the standalone 
system. A deadstart tape can be produced of the standalone 
system for execution on the hardNare* or the output of the 
Virtual Environment generator can be executed directly on the 
Hardware System Simulator. The I/O support of this standalone 
system when running on the simulator is defined In a separate 
set of common decks on a program library named •CYBICMN*. 
Refer to the Simulated I/O ERS for documentation of these I/O 
i nter faces. 

The dual -state execution of NO$/V£# In conjunction with the 
NOS operating system* requires NOS system modifications and 
the presence of a set of NOS utilities and procedure files. 
The software which supports this dual-state environment from 
the «NOS» side of the hardware is contained on a program 
library named •VE17CPI'. Included in this package of NOS/VE 
support programs is a software application called the Remote 
Host Facility which supplies job-to-job communication between 
the Virtual State and NOS portions of the CY180 machine. 



2.4.4 UPDATE THE SOURCE LIBRARIES 



The Integration project typically updates the base source 
libraries prior tc starting any recompi i at i on or assembly of 
the system. In order for a user of these procedures to modify 
the source of a system routine he/she can use the SES 
♦GETHODS' procedure to extract the source being modified^ or 
create the source in some other manner. If 6ETM00S was used 
to extract the source* then REPMODS can be used to put this 
changed source on a HAOIFY program library in the user*s 
catalog. Then the filename containing this program library 
must be specified as the value of the »AB* parameter of the 
NVEBILO procedure. (Refer to the Source Maintenance Section 
of the SES User's Handbook if you have questions about source 
ma intenance. ) 
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2«4.5 COMPILE/ASSEMBLE FROH SOURCE 



The efficiency of the Integration build procedures is a 
function of how much of the system is being built and how much 
I nf orn^at ion is supplied to the procedures when they 9^re 
invoked* If the nafl^e of each module to be recompiled and its 
object file residency is known prior to invoking the 
procedures* then the a?ost efficient method is to use the 
NVE8IID procedure and specify the lists of module names and 
library names via the »M« and *L* parameters* If only the 
module names are known* then the NVE8ILD procedure with the 
'H' parameter specified should be used <a search for the 
library names will be used). If only a modset file is 
available* the scope of changes is not readily apparent <!•€. 
several common decks are changed) or the number of modules to 
be recompiled is prohibitively large for manual specification 
to the HVEBILO procedure* then the NVEBIO procedure can to 
used to automatically generate the correct NVESILD procedure 
calls (using a NQSVEPL cross reference)* If it has been 
determined ahead of time that several modules on the same 
library are being changed* then it is more efficient to 
rebuild the entire library using the *l* parameter of the 
NVEBItD procedure. If several libraries f\ee4 to be rebuilt 
<as in a full system build)* then the NVE8IIF procedure should 
be used* 

The general philcsopy behind the NVEBILO procedure is to 
extract the latest source of a module from a program library* 
compile or assemble the source to produce the appropriate 
object text* replace/add the updated object text to the 
appropriate system library* and save this library in the 
catalog in which the procedure is executed* The final result 
of the execution of the NVEBIID procedure should be an updated 
system library in the current user's catalog which is ready 
for the 'LINKER* phase of the build* Jobs which run in "user 
mode'** that is the interface to the system is siaix through use 
of the program interfaces (OSIPD* are saved merely as object 
text files In the user's catalog and LINKER-LOADER directive 
modifications are required to include these files as part of 
the system* This latter capability will gradually be replaced 
by the Virtual State LOADER and Library Generator features as 
they become available* 
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2.4,6 BEGIN THE LIHKER-LOAOER PHASE 



The LINKER CSES.VEIINK) and LOADER iSES.VEGEN) are packaged 
together in tfie Integration procedure NVELINK* This is for 
convenience purposes^ in that most LINKER changes to the 
system require a corresponding LOADER directive change^ and 
the intermediate results from the LINKER execution are not the 
primary output used for system checkout. Prior to starting 
the LINKER-LOADER phase of system builds* some decisions need 
to be made as to the target execution environment for the 
resultantoutput. 

If the target execution environment is standalone NOS/VE# 
then the default NVELINK options should be used to produce the 
file named 'LGBOK*. This file can be run on the simulator 
using the NVESIH proce6urep or can be used to create a 
deadstart tape using the »VSN* parameter of the NVESYS 
procedure. 

If the target execution environment Is a dual -state 
environment* then the OFFSET parameter must be used to specify 
how large the NOS system vfill be. The systems produced for 
the Arden Hills S2 use 0FFSET*256 to produce a LGB256K file. 
The LGB256K file Is used by the NVESYS procedure <t*h€n 
0FFSFT*256 Is specified) to produce a deadstart tape Image on 
disk named •TP256K'. This deadstart tape Image roust then 
replace the file named TPXXXK# which the dual-state deadstart 
procedure UPiiYVE will then find* Refer to Appendix E for 
Dual-State and standalone deadstart procedures. 



2.4,7 GENERATE THE DEADSTART FILE 



In order to generate a deadstart tape for standalone 
NOS/VE# it is only necessary to run the NVESYS procedure and 
specify the VSN of the tape to be written. Prior to 
generating a dual-state deadstart file* however* it Is 
necessary to verify that the utilities necessary to support 
the dual-state deadstart have been rebuilt via the DSBILD and 
BLDEI procedures. There are two portions of the dual-state 
EI* the A170 portion is built using the BLDEI procedure* and 
the C180 portion is rebuild using the NVEBILO procedure (deck 
named HLAEI). 
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2 . 5 liM£IlLi2.£EQ£ifiUE£«l2£S£EI£Iii3li 

The procedure NVEBILD Is used to add or replace modules on 
a base object text file* NVEBIiD retrieves the source module 
frofli a program libraryt using the foMoMing search order? 

1) an alternate base optionally specified by the 
user {looking first in the current catalogt and 
then in the <Integrat I on> catalog) 

2) OSLPI ffroff the <Integratl on> catalog) 

3) NQSVEPL (frofu the <Int€gr at i on> catalog) 

This module Is then compiled or assembled^ and the 
resulting object text is either added to or replaced on a base 
file. A new version of the base file will be created In the 
current catalog* along with the direct access file NOSIIST 
which contains the coii^p i I at! on or assembly listingis) of the 
module(s) compiled or assembled (one listing per record* 
headed by the matching MADIFY module name* listed via the 
LISTNVE procedure described in this document). If there are 
any compilation errors* the error listing(s) will be put on 
the direct access file ERRORS (which has the same format bs 
NOSLIST) in the current catalog* The direct access file 
ERRIIST will contain a one line error message which Indicates 
the type of error detected for all errors diagnosed by the 
procedures. By listing the ERRLIST file from a terminal* a 
summary of the number and types of errors encountered can be 
detern'ined. There are conditions such as unrecoverable disk 
errors which can cause erroneous messages to occur in this 
file. In such case it is necessary to examine the DAYFIIE 
produced by the procedure to isolate the problem* 

If a specified module is to be replaced (i.e. it Is 
already part of the existing system)* NVEBILD will by default 
use the same compilation options and will replace it on the 
same base object text file as when it was first added to the 
system. These options may be overridden by specifying the 
corresponding parameters described below* 

If a specified module is new to the system* the compilation 
and base object text file options may be directly specified 
using the parameters described below* If a list of new 
modules is specified* the compilation and base file options 
must also be specified as lists* and NVEBILD will match 
everything up pos i 1 1 onal ly. If these parameters are uSit 
specified* and NVEBILD is executing in LOCAL mode* a warning 
message will be issued telling the user that the module is not 
in the current system. The user will then be prompted for the 
necessary Information. If these parameters are not specified 
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and NVEBILO is executing In BATCH modef the compilation and 
base file options default as specified below. 

If the *!• parameter is specified f each siodule's object 
text will be copied to a temporary 'z' file* The old library 
file will then be purged* and the *z* file will be renamed as 
the new library file* All compilation listings will be 
lI8EDIT«€d onto NOSLIST from a temporary listing file at the 
enti of the procedure* 

liilhen Bn entire library is being rebuilt via the *M 
parameter* the module names and their corresponding 
compilation options are obtained from a file which contains 
all this information for each library* NVEBILD searches for 
this file first in the current catalog* and then In the 
<Integr at ion> catalog* The name of this file iMSt be the name 
of the library minus Its first character (e*g* •LJ13F' for 
the library •XLJ13F')* and the first line of this file mu^l be 
the file name. To make additional entries or change existing 
entries in this file* the following procedure should be 
f I lowed ! 

1) €XTRACT*<I ibdeks>/UN=<Integration>. 

Iwhere <libdel<s> is the name of the compilation 

information file for the library as described above* and 
<Int€grat i on> is the Integration catalog! 

2) Edit <llbdeks> to add or change entries. The format and 
spacing of each entry is important and must be as follows? 

C<m>*<c>*<xref>»<II>*<l2>) 
where 
m s a y-character I eft- just I f I ed module name 

c * a l-character compilation option ('0»*«1«* or *3'* 

see description of *c* parameter below) 
xref » a 3-character left- just i f i ed cross reference 
option (either 'YES* or » NO «) 

11 « a T-character left-justified destination library 
name • 

12 » a T-character left-justified secondary library 
destination name* 

the entries currently in these files all follow this 
format so that any additional entries may be lined up 
quite easily with them. 

3) SAV£*<I ibdeks>* 

NVEBILD (with the •!* parameter specified) may then be used to 
rebuild the library using these new/modified compilation 
options* 
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The format of the NVEBILD is as foHowss 



SES.NVeeiLD 



I f!?=C<fnody I e naffie>**<fliody I e iisme>) 3 

C l«< I ibrary name > 1 

I c«{<compi I at ion opt ion>* •<coaipi I at I on option>) 3 

C area » < user na!f?e > 3 

I xref=l< xref opt i on>. •<xref option>) 3 

C ab » <alternate base> 3 

C oroit » {<fliody|e naf«e>»*<module naffie>) 3 

I link S link « <offset value> 3 

I test « <test file name> 3 

I print 3 

C batch 3 



The ffiodule naroe^ or range of modules* or 
module nanes* 



list of 



1 : 



The library narseCs) onto which a ne*«ly compiled 
module Cor modules) is Care) to be added or 
replaced* If the 'H* parameter has not been 
specified* then the entire library is recompiled* 
To recompile several libraries at a time it is 
r ecoffifliended that the NVE8ILF procedure be used* 



c s 



c « to asseirble a module 

c = 1 to compile a CYBIL module CDEFAULT) 

c - 3 to compile a CYBIL module using CY8ICMN type 

dec I arations 



area ? Option to obtain the object files or linker 
parameter files from another user's catalog Cother 
than the current catalog in which the procedure Is 
executing). The default is for no area user 
catalog to be searched* 



io s 



List options to be in force during CYBIL 

compilations* May be any combination of A* C# F» 

Q* !♦ Wf R* or (zero). The default Is 
C zer o) . 



ab J 



The user's alternate base program library 
containing new and modified modules* The default 
Is 'NEWDKPL'. 



omit i Used when running a full builds a module name or 

list of module names to omit from the build* The 
default is none* 
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link s Option to link the newly built or modified system 
using the procedure NVELINK* Specifying siiRply 
tfie keyword »LINK* or «LINK « 0« links a NOS/VE 
stand-alone systes). To link a dual state systen* 
specify «LINK « <offs€t>' where <offset> may be 
given the values 256* 128# or 64. The default is 
to not link the system. 

test s The name of the file containing the NOS/VE test 
cofliBiands to be input to the simulator* which will 
be executed after the system has been linked 
(using procedure NVESIM). This parameter Is 
invalid if the 'LINK* option has not also been 
specified* The default is to not run the 
s i n^ul at cr test. 

print s Option to print the link n?ap following the linking 
of the system. The default is not to print the 
I i nk map* 

batch J Run NVEBIIO in BATCH mode. The default is to run 
It locally. 

MOIi 5 Cne of 'm* or *M parameters msi be specified. 



2.5.1 NVEBILF PROCEDURE DESCRIPTION 

NVE8ILF is an SES procedure file which submits one batch 
procedure execution of NVEBIIO for each system library* each 
with the <M parameter specified for the library to be built. 

The format of the NVEBILF is as foilowss 

SES. NVEBILF C I « <library name >1 
I batch 3 

I ? The *!• parameter specifies the library to be 
built. It can be one library or a list of 
libraries. The default Is to rebuild the entire 
system. 

batch J Run NVEBILF In BATCH mode. The default is to 
run it locally. 

Note : To rebuild one library* the following are logically 
equi val enti 

1) SES.NVEBILF l«< library name > 

2) SES.NVE8IL0 l*< library name > batch 
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The expansion of either of the above procedures can be 
prohibitively long when being run froirs a terminal* The 
•batch* keyword on the NVEBIID procedure is implemented for 
the express purpose of freeing up the terminal for other 
purposes (the procedure expansion is done *«ithin the BATCHed 
J obi* 



2*5*2 I^VEBID RROCEOURE DESCRIPTION 

The NVEBID procedure generates %n^ routes to the input 
queue a set of NVEBIID jobs which compile the modified or 
replaced decks and those decKs which call modified or replaced 
coiiiii?on decks* Firsts NVEBID finds the decks modified by 
creating a list of all the *DECK lines \n the »mf* fileCs) and 
a list of all the decks in the «dkf« flle(s)« It combines the 
two lists# sorting and deleting duplicate names* The combined 
list is checked against the current list of modules which make 
up NOS/VEf using the cross reference file from the •xrf* 
parameter* Then the procedure again creates two lists? a list 
of modules to be compiled and a list of common decks to be 
checked* A subset of the cross reference is used to generate 
a list of all decks referencing the given common decks* The 
list of modules and the list of decks referencing the modified 
common decks ^re combined* sorted and duplicates are removed* 
This final list is then used to generate the NVEBILD jobs to 
compile the necessary modules* 

The format of the NVEBID is as follows: 

SES*NVE8L0 C mf « <file_name> 3 

C dkf » <f i le^name> 3 

I xrf « <f i le_name> 3 

I nl = <l i brary_nam€> 3 

C area « <user_name> 3 

I ab « <f I I e.name> 3 

£ batch J local J defer S batchn 3 

mf J The file or list of files which contains the 
modsets or a list of *OECK deck^names* If the 
parameter is omitted the file MQDFIIE is used* 

dkf J The file or list of files which contains the new 
or replacement decks in a group file format* If 
the parameter is omitted the file OECKFIL is 
us ed* 

xrf : The NOS file name for the file containing the 
cross reference of NOSVEPL* If the parameter Is 
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nl 



offiitted the file XNVEPL is used. 

The list of library names to be omitted from tl?e 
build* There Is no default. 



ares s The search order to find any file. If the 

parajueter is ofultted the user names of the current 
user and the user name of the procedure are used 
for the default user nanses. 



ah I 



The file name of the alternate base. The default 
is NEyOKPL. 



batch « local \ defer J batchn J The Job run mode of the 
procedure. If none are defined LOCAL is used. 



2.5,3 LISTNVE PROCEDURE DESCRIPTION 

LISTNVE is an SES procedure file »«hi ch extracts the 
compilation listings of the modules specified by the «M* 
paraineter (module names correspond to the MAOIFY deck name 
given the module) from a text library file and writes them to 
the file specified by the 'F* parameter in a printable 
format. The 'M' parameter may select a single module* a list 
of modules* and/or a range of modules on the library file. 

The library file which contains the listings may be 
selected via the »n parameter* and defaults to NOSLIST. 
LISTNVE will search for this file in the current catalog 
first* and if it Is not there it will go to the catalog 
specified by the 'UN* parameter. 

^hen LISTNVE has completed* the output file selected by the 
♦0« parameter will be a local file. It is U2X automatically 
printed unless either the 'PRINT* or •BATCH* option Is 
sel ec ted. 

The format of the LISTNVE is as foHowsJ 



SES. LISTNVE 



t m « { <mGdule name>. .<modu I e name> 

I I « <f i le name> 3 

Z « <print file name> 3 

t un « <user name> 1 

t print ] 

I batch 3 



> 3 



m J 



The module name(s) 
names which are 



and / or range of module 
to be extracted for 
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printing* The default Is to extract and 
foriRat jil of the modules* 

i i f » from s The name of the text library file froir? 

which the compilation listings are to be 
extracted. The default is NOSLIST, 

o ; to 1 upon J The name of the file which will receive the 

formatted listings to be printed* The 
default is LISTING. 

un 5 The nafPe of the catalog to search for the 

library file should it not be found in the 

current catalog. The default is the 
<Integr at ion> catalog* 

print s Option to print the listing file after It 

is formatted. The default Is to not print 
the I i st i ng file* 

batch J Run LISTNVE in BATCH mode. The default is 

to run it I ocal I y. 



2 . 6 NM£LlHE^££D££J2ySI^n£5£EI£IIQi 

NVELINK is an SES command language procedure file which 
will call both the VE Linker Bnd VE Generator (using the 
standard SES procedures VELINK and VEGEN) to produce a 
checkpoint file and link map file. In order to do this it 
will link monitor and task service routines from their object 
text files. It i«ill search all files that it requires 1) from 
local files 2) from the current catalog* 3) from area user's 
catalog <lf the area parameter Is specified)* 4) from the 
<Intesr at ion> catalog. 

NVELINK will link either a stand-alone or a dual state 
system. The choice is made via the OFFSET parameter (see 
description below). NVELINK will put the checkpoint file on 
the direct access file LGB<of f set>K* and the link map will be 
placed on the direct access file iiAP<of f set>Kf where the value 
given the OFFSET parameter Is substituted into each name for 
<offset>. 

To link additional user jobs into the system* create a file 
in the current catalog containing the commands needed to 
obtain ail the necessary files as well as a call to VELINK for 
each user job to be linked. Specify this file via the ADD 
parameter* and NVELINK will pick it up and physically insert 
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It into procedure comniand stream ifninedi atel y following the 
last call to V E 1 1 N K , ItlJS-f i£^i-ii D£ -ill-illiS-lii5-.llilM^ H S^tlll 

The forffif^t of the NVELIHK is as followsJ 

SES.HVELINK C offset « < load offset > J 

C ps « < page si ze> 3 

£ pti « < page table length > 3 

C snve 1 

t quick 3 

C add » < additional links file > 3 

C dump 3 

C area « < user name > 3 

£ print 3 

£ test « < test file name > 3 

£ batch 3 

offset 5 The lead offset* used to determine whether to 
link a stand-alone or a dual state system* 
OFFSET » C links a stand-alone system (DEFAULT) 
OFFEST « 256 links a dual state system < to use 
on the S2) 

OFFSET « 128 links a 128K dual state system 
OFFSET « 64 links a 64K dual state system 

ps 5 Page size of the target NOS/VE system* expressed 
In multiples of 1024 bytes* Values may be 1* 2* 
4* 8* 16# 32* or 64* Default is 8* 

PtI 5 Page table length of target NOS/VE system* 
expressed In multiples of 1024 bytes* Values 
may be 4* 8* 16* 32* 64* 128* 256* 512* or 
1024. Default is 16. 

save s Option to save the monitor and task services 
segment files created during the link for 
subsequent "quick link" use by this procedure. 
The default is not to save these segment files* 

quick 1 Option to do a "quick link"* A more complete 
description of this option can be found In the 
section entitled "Quick Link Option of NVELIHK 
Procedure"* The default is not to do a quick 
I ink* 

add 5 The name of the file containing the commands 
needed to link additional user jobs into the 
system* The default is to not link in any 
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additional user jobs* 

dump s Option to print a fliemory dump of the systew* 
Default is no memory du^p. 

area s Option to obtain the object files or linker 
parameter files from another user's catalog 
(other than the current catalog in which the 
procedure is executing). The default Is for no 
area user catalog to be searched* 

print s Option to print the link wap* The default is 
not to print the link map* 

test 5 The name of the file containing the NOS/VE test 
commands to be input to the simulator^ which 
will be executed after the system has been 
linked (using procedure NVESIM)* The default is 
to not run the simulator test* 

batch J Run NVELINK in 8ATCH mode* The default is to 
run it locally* 



2.6*1 iPF FILE DESCRIPTION 



The LINK commands used in the NVELINK procedure do not 
specify enough information to totally define the reguir ewients 
of the linking operation* Many additional parameters are 
supplied to the linker through additional data files* This 
includes information such asJ 

~ R ing Numbers 

- Segment Numbers 

- Segment Attributes 

- Execution Privilege 

Currently this information is supplied to the linker via 
the S€S Linker Parameter File (LPF) file* The linkage between 
the linker and the LPF file is activated by the LPF«LIBLCB 
parameter on the LINK commands* For the monitor linkage this 
inforrration is on LPF file MTRLCB* task services linkage 
information is on LPF file STSLCB* and EI/EIE linkage 
inforn?ation is on EILCB/EIELCB respectively* 
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2.6*2 VEIOCH / LOR FILE DESCRIPTION 

The VELDCH file used by the procedure NVELINK contains 
directives to the CPF Geiierator which allow It to produce a 
checkpoint file froiii the segment files produced by the VE 
Linker* These directives set up the physical environment Into 
which NOS/VE Is placed* and Include such things as the 
definition of the page size* Job and monitor exchange package 
addresses* page table address and length* preal located segment 
array definitions* etc* 

VFLOC^I Is a "skeleton" file which Is dynamical ly edited 
during the execution of the NVELINK procedure* depending upon 
the specification of the OFFSET* PS* and PTL parameters* The 
edited file is then put on a direct access file named 
LDR<offs€t>K (where <offset> Is replaced by the value given to 
OFFSET when the procedure was called) In the user's catalog* 
It contains the directives to the CPF Generator which set up 
the physical environment for that particular link. This file 
must re»!!ain permanent in the user's catalog after NVELINK has 
been executed* as the procedure NVESYS uses this file in 
building a deads tart tape. 



2 . 7 iI2illll£^yS£E.IAaKl.IG-IIimjt 



2.7*1 INTRODUCTIOH 

h user task can be defined as a group of modules linked 
together that will execute In the 'user ring* of NOS/VE* 
currently ring 11. This task may make calls to any gated 
entries within task services (rings 1 through 3) If the call 
bracket will allo>« the call* Data defined within task 
services may not be referenced from rings 4-15* 



2*7*2 QUICK LINK OPTION OF NVELINK PROCEDURE 

To do a "quick link"* specify the QUICK option on the call 
to NVELINK (see the section entitled "NVELINK Procedure 
Description )* In this case NVELINK does not link monitor and 
task services from their object text files each time* 
Instead* it uses al£Sai3l-.-llClSSj monitor and task service 
environments* and just links the specified user object files* 

The QUICK option causes NVELINK to run faster and requires 
less resources than the full link* and therefore should be 
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used instead of the f u M link when Xifilx_JiS££«tJSiSS are being 
added to NOS/VE* 

NVElINKf v*lth the QUICK option specif I edf should not 
require any incdi f I cat! on to execute in different user task 
configurations. The user can merely add the user object text 
file produced toy an assembly or compilation to the XLJ8BB file 
using the SES.GOF procedure* To link additional user object 
files into the system* specify the necessary comwand file via 
the ADD parajneter* The contents of this file* Its use* and 
the function of the UJ and ADO parameters are described In 
greater detail in the section entitled »»NyELINK Procedure 
Descr ipt ion"* 



2 . 8 MQS/^£-.^I!!iyLAIiOM 



2.8*1 RUNNIHG A SIHUIATOR TEST CNVESIM PROCEDURE) 

NVESIH is an StS procedure file which will run either a 
batch nraode or an Interactive siniulation of NOS/VE* This 
option is selected via the 'TEST* parameter. If <T€$T' is not 
specifiedf then the simulation will be run interactively* If 
a batch mode simulation Is deslredj then 'TEST' is used to 
specify the name of the file containing the NOS/VE test 
coir^mands that are to be input to the simulator* The * BATCH* 
keyword jrust also then be specified* If the user wants to use 
his/her own simulator directives file* the 'CMOS' parameter 
must be specified* 

NVESIH also allows the selection of the checkpoint file to 
be used for the start of simulation* A checkpoint file way 
also be optionally saved at the end of the test* The C180 
memory size may be changed via the 'MEM* parameter* 

The NVESIH procedure will create several permanent files in 
the user's catalog if not run interactively* These are 
I temi zed as f o I I ows J 

1) I£ill£yi« This direct access file contains all of the 
output of the NVESIH procedure* including 
~ a copy of the command file used as input to the 
simulator ('TEST* parameter) 

- the output produced by the system 

- the SESLOG f i le 

- a reformatted keypoint listing 

- DEBUG output Cif 'SIMOBG* was specified on the 
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NVESIM call) 

- a sufliffiary of all (paging) disk I/O (HIOIOG file) 

- ttie load iRap produced by the CITOII conversion an4 
execution of XUUTt (SIHLOAO file) 

~ (optionally) a hex dump of the checkpoint file at 
the end of si my tat ion 

- the job dayf i I e* 

This file Is automatically sent to the line printer* 

2) liliBEf* This direct access file contains the key point 
data produced by the siirsulator. It is reformatted fey 
the procedure NVEKEY before being written to the file 
TOUTPUT, 

3) lUAlt* The dayf lie of the NVESIH job will be written 
to this direct access file should it terminate 
abnormal I y* 

Add! t i onal I y:> if the »NCPF« parameter is specified* NVESIH 
will create 4 direct access flies which together contain the 
NOS/VE environment at the end of s infiu lat ion» The file 
specified by the «NCPF* parameter will contain the current 
NOS/VE checkpoint file. The other 3 files (forined by adding 
the characters Qf 1> and 2 to the •NCPF* file name - which 
must therefore be six or less characters long) are used for 
NOS/VE pemory paging. 

The format of the NVESIH is as follows! 

SES.NVESIH t test - < command file > 3 

I cm6s « < simulator directives file > 3 

C cpf a < checkpoint file > 3 

I ncpf « < new checkpoint file > 3 

t mem « < memory size in hex > 3 

C nods 3 

t run * < instruction count > 3 

£ simdbg 3 

l dump 3 

C batch 3 

test s The file containing the NOS/VE test coBimands. 
The default is to run Interactively* 

cmds 5 Simulator directives file which should be 
supplied by the user* The default is to use the 
one created by the NVESIM procedure* 

cpf 5 The checkpoint file used for the start of 
simulation* The default is "IGaOK^* 



2-21 

ADVANCED SYSTEHS INTEGRATION PRQCEOURES MQTE800K - Build N29 

2,0 OVERVIEI^ OF INTEGRATION PROCESS 

2*eM RUNNING A SIMULATOR TEST (NVESIM RRQCEOURE) 



ncp f * The checkpoint file to fee saved at the end of 

simulation. The default is not to save a 
check po In t file* 

jrew » The C180 Riachine memory size> in hex> needed to 

run the simulation* The default is 
«1G00C0U6)"« 

nods 5 Option to use the version of the checkpoint file 
from the <Integr at ion> catalog *ihich has already 
feeen ceadstarted* The default is to use a 
checkpoint file which has not been deadstarted* 

run 5 A count of the nuojber of suimulated instructions 
to execute. The default is 800000 instructions 
(or the profile variable value for «RUNCNT»)# 

siindfog s Option to turn DEBUG on for the current 
sifnuiator run. The default is to run *iith DEBUG 
off. 

dump ! Option to include the duwp of the checkpoint 
file at the end of sifnulation as part of the 
NVESIM output. The default Is not to dump the 
checkpoint file. 

batch s Run NVESIM in batch mode. The default is to run 
it locally. 



2.8.2 NVEKEY PROCEDURE DESCRIPTION 

NVEKEY Is an SES procedure file which creates a simulator 
generated keypoint trace file. The output of this procedure 
is the local file •KEYFIIE*. 

The format of the NVEKEY is as followsJ 

SES. NVEKEY C kpf * < keypoint file > 3 
C format « < SIM J HDW > 3 

kpf s The keypoint file generated by the simulator 
which is used as Input to XXH7KEY. The default 
is «S£SSMKF». 

format s Specifies *<hether simulator or hardware format 
keypo Ints are being processed. Default Is 
•SIM* . 
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2.8.3 DUMPING A SIMULATOR CHECKPOINT FILE CNVEOUHP PRQCEOURE) 

NVEOUHP Is an SES procedure file which makes a DSDI dump of 
a simulator checkpoint file. 

The format of the NVEOUHP is as foliowsi 

SES. NVEOUHP £ cpf « < ctieckpoint file > 1 
C I = < output f i le > 3 
C dump * STNO I ALL 3 
C print 3 
C batch 3 

cpf ! The checkpoint file which Is to be dumped. The 
default is "CKPT«. 

I s The file which Is to receive the dump output* 
This file will be a local file after the 
procedure has finished execution. It is nfii 
automatically printed* The default Is 

«DSOIOUT". 

dump I Option to either dump the environment according 
to ASID (DUMP-STND) or dump the entire 
environment (OUMP^ALL). If «DU«P«STND" is 
chosen^ then the OSDI directives are taken from 
the file OSDIXf which the procedure will search 
for first In the current catalog and then in the 
<Integr at I on> catalog. The default is 
"OUMP«STND". 

print J Option to print the DSDI dump output. The 
default is not to print the dump. 

batch : Run NVEDUMP in BATCH mode. The default is to 
run I t I ocal ly . 



2 . 9 £yiLlJIUiS.A-a£AC5IiEI-EIL£ 



2.9.1 INTRODUCTION 
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2.9.2 CREATING THE FILE (NVESYS PROCEDURE) 

The SES procedure HVESYS builds a deadstart file from the 
checkpolr>t file created by the linking of the system. The 
•OFFSET* parameter allows the option of building either a 
stand-alone or a dual state deadstart file* If the parameter 
»¥SH* is specified* then the deadstart file *«l H be written to 
tapel otherwise It is written to the file TP<Gffset>K where 
the value of the 'OFFSET' parameter is substituted for 
<offs€t> in the name of the file* 

NVESYS requires additional object flies for inclusion on 
the deadstart file. These object files contain P9 object code 
for the following functionsJ 

1) Deadstart (file XIDST) 

2) 844 driver (fiie XIDSK) 

3) Console/Printer drivers Cfile XIDSP) - standalone 
only systems 

4) PP helper (file XIHIP) - standalone only systems 

5) PP Resident program (file XIRES) - standalone only 
systems 

6) NOS/VE disk driver (file XDISK) 

7) NOS/VE HCU Driver (file XHSPHCU) - standalone only 
systems 

8) Dual State HCU Driver (file XMCUPP) Dual State 
only systems 

9) Others to be defined later 

If these files are not present in the current user catalog* 
they will be obtained from the appropriate catalog. ( i e* 
S£S*INT2. prefixed procedure calls access INT2 level system 
files only* while SES*INT1. prefixed procedure calls may 
access files fronB either INT2 or INTl catalogs as is 
appropriate for the system feeing built.) 

A copy of the llnkmap file ( I Inker / 1 oader output) will also 
be included on the stand-alone deadstart file. A copy of the 
loader directives will be included on the dual state deadstart 
file. These are the files HAP<offset>K and lDR<offset>K 
(descriptions of these files are included in previous 
sections)* and must be in the same catalog as the file 
specified by the »CPF' parameter. 

The format of the NVESYS is as follows? 



SES.NVeSYS 



C vsn = < tape vsn > 3 

I offset = < load offset > 3 

C cpf « < checkpoint file name 



> 3 
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C cybHnk 1 
C batch 3 

vsn s The VSN of the tape to be written* This file 
n^ust be available to the operator* The default 
is to write the file to a tape as specified 
above* 

offset s The load offset* used to determine i^hether to 
build a stand-alone or a dual state deadstart 
f I le* 

OFFSET = C builds a stand-alone deadstart file 
(DEFAULT) 

OFFSET « 256 builds a dual state deadstart file 
(to use on the S2) 

OFFSET « 128 builds a dual state deadstart file 
for a 128K system 

OFFSET « 64 builds a dual state deadstart file 
for a 64K system 

cpf t The checkpoint file used in creating the 

deadstart file* If the file does not exist in 
the current catalog* it will be obtained from 
the <Integrat lon> catalog* The default is 

IG80K* 



cyblink s Option to create a tape for CY8ERLINKIN6 to 
CANCCD* The default is to build a hardware 
deadstart file* 

batch ? Run NVESYS in BATCH mode* The default is to run 
it locally* 



2*9*3 COr^PILING 180 PP CODE <CPP180 PROCEDURE) 

CPP18C is an SES procedure file which compiles 180 PP 
code* The source for the PP code is retrieved from a source 
program library. If the "A8»* parameter is specified* CPP180 
will search this PL first before searching NOSVEPL to satisfy 
externals* The "UN** parameter specifies the catalog In which 
**AB»» residies* NOSVEPL comes from the <Integr at I on> catalog* 

The format of the CPP180 is as foMowst 

SES*CPP180 C m « < module name > 3 

C ab = < alternate base > 1 
C batch 3 
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m i The fi^odule name of the ?P program to be 

coppi I ed* 

ab 2 The alternate base searched fey CPP180 to satisfy 
externals before searching HOSVEPL* The default 
is to search only NOSVEPL* 

batch i Run CPP180 in BATCH mode. The default is to run 

it locally* 



2.10 nyAL^SIAI£.£EQ££iiy££l 



2.10,1 BIDEI PROCEDURE DESCRIPTION 

BLDEI is an SES procedure file which builds the absolute 
file for dual state €I« The AB paraiseter may be specified If 
a program library containing the dual state £1 source exists 
in the current catalog; otherwise BLDEI retrieves EI from 
NOSVEPL in the <Int egr at i on> catalog. 

BLDEI uses the linker parameter file EILCB to link £1. If 
this fil€ does not exist In the current catalog* it is 
obtained frcni the <Integr atl on> catalog by the procedure. 

The outputs of BLDEI include the direct access absolute 
file «EI' and the direct access file «DSLIST« which contains 
the assembly listing and the link map for EI. 

The format of the BLDEI is as follows: 

SES. BLDEI C i » < EI source file > ] 
I area « < user name > 3 
C batch 1 

i J The file in the current catalog which contains 
the dual state EI source program library from 
which EI Is to be built. The default Is to get 
the £1 source from NOSVEPL in the <Integr at I on> 
catalog. 

ab I The user's alternate base program library 
containing new and modified modules. 

area J Option to obtain the object files or linker 
parameter files from another user's catalog 
(other than the current catalog in which the 
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procedure Is executing). 



2. 10.2 DSeilD PROCEDURE DESCRIPTION 

DS6ILD is an SES procedure file which but Ids the dual state 
binaries XDSTVE* XRUNVEf and XTRH¥E. All assembly and CYBIl 
compilation listings are put on the direct access text library 
file OSIIST < one listing per record^ each headed by the 
corresponding HADIpy deckname) and the three load maps are 
BPPendeii to the cofipl la 1 1 on and assembly listings* 

The format of the DSBILO is as foMowsJ 



SES .DS BUD 



ab 3 



batch i 



C ab « < alternate base > 3 
C batch J 

The user's alternate base progra 
containing ne^t and modified modules* 



Run 0S8IID In BATCH mode. 
it locally* 



I Ibrary 
The default Is to run 



2*11 yilLlII.£ED££DiJSf5 



2.11.1 NVEREP - REPORT SYSTEM CONTENT 
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The format of the NVEREP procedure is as follows^ 

SES. NVEREP I left « < primary key > 3 
I right « < primary key> 3 





area 




f « < 




a < 




1 * < 




print 




batch 
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• < alternate user name > 3 
input source > 3 
output destination > 3 
library naine > 3 
3 
3 

left t Primary sort key for left side of two paged 
report* Only the first two characters of this 
paran^eter are significant. May be either 
Module* MAdifyf Library* or LAnguage* (An 
additional optiont VErslon# is only available 
when used in conjunction with partner 
procedures* Option BUild is under consideration 
for future impl efsentat ion. ) The default for 
this parameter Is MOdule* No validity checking 
is performed for either the »left« or •right' 
parameter values* and an invalid specification 
will result In a report which may differ frop 
that desired* 

right s Primary sort key for right side of two paged 
report* See parameter left for valid 
specifications* Default Is MAdify* 

area J Alternate user name to search first for the 

input file specified by the 'f* parameter* 

Default value is «nulM* and source for *f' is 

found in the user name where the procedure 
resides (PRCUNAM)* 

f s Name of the file containing build content 

information* Default is PROCLIB* 

! Name of the file to receive the two paged 

report. Default Is VEREP. (The files LEFT and 
RIGHT currently remain local after the procedure 
has completed* These files contain the left and 
right hand portions of the two paged report*) 

1 ! Name(s) of NOS/VE library (or libraries) which 

are to be included In the report* Default is to 
report on all primary NOS/VE libraries* 

print : Keyword to cause output file to be printed* 
Default is to not print the report unless batch 
execution has been selected* 

batch J Keyword to cause the batch execution of the 
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procedure* Default Is to run the procedure In 

HOCAt« fRode. 



2.11.2 PROCEDURE GET - GET A LOCAL FILE 

The GET procedure makes some assumptions about files which 
prove convenient to the procedure writer* The first 
assumption is that any files named by the user represent files 
which are to be modified or interrogated without worry as to 
the access mode of the file (it may be either a DIRECT or an 
INDIRECT access permanent file). The second assumption is 
that the file named by the user may already exist as a local 
file* and If it does that the current local copy of that file 
is the correct version of that file. The procedure's function 
then is to leave currently existing local files alone (unless 
they are attached DIRECT files)* and find any remaining files 
to add them to the list of currently active local files. The 
user may wish to specify a search order for the list of files 
to be added to the local file list* and may do so by providing 
a list of user names (in search order* left to right) via the 
*UN» parameter. The user may also wish to accumulate a number 
of files upon one filename* and may do so by providing a 
filename for the »HF* parameter. 

The format of the GET procedure is as followsJ 

SES.GET £ < I fn > ] J C < pfn > 3 
C <un> 3 
C < mf > 1 

C msg 1 

I f n 5 Local file name by which the file Is to be known 
(may be a list of files). If no filename is 
specified for Ifn* then the filename value for 
the •PEN* parameter is used. One of either 
UFN» or «PFN« must be specified. All 
parameters may be specified pos i t i onal ly* so the 
typical usage of this procedure would beJ 
SES.GET (HYFILE1,HYFILE2* ... *etc.) 

pfn 5 Permanent file name of the file to be made 
local. If no filename is specified for pfn* 
then the assumed value is that specified by the 
•LFN» parameter. The list of pfn values is 
matched positionally with the 'LFN* specified 
values. This is illustrated as follows: 
SES.GET (one*two) (stuf f l*stuf f 2 ) 
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un 8 



f!jf : 



mg 



An optional list of user nawes which directs the 
procedure's search order for files which are 
currently not local* This is convenient if the 
user knows that the file exists in one of 
several catalogs* but Isn't sure where to look. 
An example would bei 
SES.GET ipndoc UN«C in tlf I nt2* devlf dev2f re 1 1) 

A filename upon which to stack the named files 
(one file per NOS record). For examplei 
SES.GET (ipndoc^bcr) MF«bildoc 

Keyword which causes the generation of messages 
to describe what the procedure is doing. If for 
exainple the location of a file is in several 
user catalogs* the msg keyword would issue 
inessages indicating which catalogs Cspeclfled by 
the 'UN* parameter) had been searched for the 
filet and where it had finally been found* 



2.11*3 PROCEDURE SAVE - MAKE A LOCAL FILE PERMANENT 
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The format of the SAVE procedure is as followsJ 

SES.SAVE C <lfn> 3 ! t <pfn> 1 

I <un> 1 

C msg 3 

I dir 3 



Ifn 



Local filename to be made permanent. Defaults 
to 'PFH* value if not specified. One of 'LFN' 
or •PFN* parameters must be specified. 
Parameters may be specified pos i t iona 1 1 y > and 
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typical usage would bes 
SES.SAVE (xlR?mtr*xiJMbf 



f etc*) 



pfn ? 



Permanent filenaine for files to be saved* 
Defaults to »LFN* if not specified. ¥¥H values 
are patched positional ly within the list to LFN 
values. This is illustrated as foHowss 
SeS.SAVE {one#t»«o) (s tuff 1# stuff 2) 



un « 



ffisg s 



User Nafl?e in which to save the local file* This 
parameter is only valid for DIRECT access files 
for which write permission has been granted (in 
another user*s catalog). 

Keyword which causes the generation of messages 
describing the nai^es and destinations of files 
being saved* 



dir I 



Keyword which directs the procecure to make all 
naiiied files DIRECT access files* regardless of 
their size. 



2.11.4 NVEHAP - REFORHAT NOS/VE LINKMAP 



NVEHAP is a procedure to reduce the number of 
printed pages of a NOS/VE linkmap* while 
maintaining readability* and to provide sumrnary 
reports of information contained wihtin the 
Hnkmap. Either all» or portions of the llnkmap 
may be processed. The reformatted form of the 
linkmap is also suitable for microfiche* in the 
format defined for the NOS/VE operating systeflR. 



The format 

f O I lows! 



of the NVEMAP procedure is 



as 



SES.NVEMAP 



< i nput file > 3 

< output f i le> 3 



I 



area « < 
copy * < 
skip « < 
print 3 
gated 1 
fiche 3 
module 3 
save 3 
two 3 
batch 3 



alternate user name 
record count > 3 
record count > 3 



> 3 
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I 3 Input file which contains generated output from 
the execution of the NOS/VE CI Cor SES) Linker. 
Default is MAP256R for systeiss prior to the 
system restructure (Prior to 8ulld 0)# and 
HAPHXX for restructured systems. 

! Nai!?e of the output file to receive the 

reforwatted linkwap file. Default Is to produce 

a local file of the same name as specified by 
the • i • parameter • 

area s Alternate user n^me to search for the Input file 
specified by the 'M parameter* Default value 
is * n u I I • . 

copy I Count of the number of NOS records to process 
from the current file position of the Input file 
(default position BOI). Each invocation of the 
linker produces a new record upon the output 
file. Thusj to process only the first portion 
of the linkmap (typically Monitor for the NOS/VE 
Operating System) •C0PY«1« would be specified. 
Default value for this parameter is to process 
the entire llnkmap BOI to EOI. 

skip J Count of the number of NQS records to skip prior 
to processing. For the NOS/VE operating system 
«SKIP«2« would suppress the Monitor and EI 
portions of a Dual State linkmap* •SKIP«2 
C0PY«1» would process only the Task Services 
portion of a Dual State llnkmap. Use of either 
the 'skip* or 'copy* parameters infers explicit 
knowledge of the content the llnkmap* Due the 
the number of variations of llnkmap which can be 
produced it would be impractical to generalize 
these parameters in a more logical manner. 

print ! Keyword to cause output file to be printed. 
Default is to not print the reformatted 
llnkmap, « PRINT«TWOHAP« will print the contents 
of file named TWOMAP. Key «PRINT« will print 
TWQMAP if key 'Tyo* is also specified* otherwise 
the file specified by the 'o* parameter will be 
printed. 'PRINT-ALL* will print both TWOMAP and 
the file specified by the *o' parameter. 

gated i Keyword which eliminates Information for all 

entry points which do not have the CATEO 
attribute. Conceivably* a combination such as 
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•SKIP»2 COpy«l GATED* would produce inforfnation 
to a compiler project about which entry points 
within Task Services are GATED for their use. 
Default is to produce reports of all system 
entry points* 

fiche 1 Directs the procedure to place the output of the 
procedure onto the file NQSLIST for subsequent 
fi!lcrofiche processing. Default is to not add 
the I inkiBap to the NOStlST file. 

module s Keyword which causes the removal of all entry 

point information from the llnkrpap. This proves 

useful for auditing Biodule attributes. The 

default Is to retain all system entry point 
inf or iTja t i on. 

save J Keyword which causes the output files to be 
retained on permanent files for subsequent 
Inspection. This option is selected if 'batch* 
has been specifiedf otherwise it Is left to the 
discretion of the user to dispose of the local 
copies of the output files. 

two t Keyword which directs the procedure to twopag* 

the linkieap onto the file TyOHAP. TWOHAP will 
always be generated* but will only contain the 
summary report information unless 'two' is 
specified. This twopage option is not the 
familiar SES TWOPAGE option* but rather a 
computed split and merge of the reformatted 
map. 

batch t Keyword to cause the batch execution of the 

procedure. Default is to run the procedure in 
«LOCAL* mode. 

This procedure will always produce two output files. The 
primary output file is governed by the 'o* parameter. A 
secondary output •TWOMAP* is always produced as well. The 
»TWOHAP« file will only contain the summary reports and 
losdmap If parameter 'two* is not selected. The first summary 
report which is produced Is a two paged report of PVAs found 
in the linKmap. The left hand portion of this report Is a 
sort by PVA. The right hand portion of this report Is a sort 
by module and/or entry point name. This report should answer 
the questions? 1. Given a PVA* in which module and/or 
procedure is that PVA contained?* 2. Given an entry point 
name* in which module is it defined and what is its PVA?* and 
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3* Given the name of a variable within 
table* what is its location within a <iufl?p? 



a systciii defined 



The final report is a two part error surnroary for the 
linkffiap. The first portion of this report Identifies which 
pages of the linkmap contained one or reore errors. The second 
portion of this report is a list of all of the errors found 
within the linkmap* in the sequence in which they appear In 
the ro a p • 
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3 . ayAL.SIAI£«iMSIiLLAIii]N^S£iSy£M£f 



This section describes ho^ to install all of the files 
needed to run NOS/VE In Dual State pode. To do this from 
"scratch** the folio^ting niaterlals are necessarys 

1 HIVS tape 

1 Dual State NOS Deadstart tape 

~ The LOADPF tape(s) which contain the NOS/VE environment 



If HIVS and CTI »re already present and correctf then it is 
only necessary to install a new deadstart sector on disk or to 
load a new NOS/VE environment. If A170 NOS has been run on 
this machine prior to the installation of NOS/VE# then chances 
are excellent that the proper versions of HIVS and CTI were 
us ed. 



3,1 £i£iE.£I3IMI££i-i!ia-IM5IAiL«i:iI 

To clear the pointers* deadstart from the Dual State NOS 
Deadstart tape which is NT* D«PE» F«I# LB«KU> and enter* 

^yt^ >*I* >R (Release) 

Channel*xx 
Eq = xx 
U n i t « X X 

Deadstart again from the same deadstart tape as above and 
then enterJ 

*U:{. >:Ocit XCR) (Install D/S module on disk) 

(CR) {Proceed - Response to warning) 
Channel«xx 
€ q« x X 
U n i t « x X 



3,2 IMIAiL.ai^l 

To install HIVS* deadstart from the HIVS tape which is NT* 
D*PE* F=SI* L8«KU* and then enters 

*U* >*T* (Select TDX option) 
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•C* optlors <8yHd directory in CM and copy to disk) 
Disk type*x 
Disk Channel *xx 
Disk €q*xx 
Disk Unit* XX 
HT type«3 
MT channel *xx 
€q«xx 
Unit^xx 

User type«C2 (Shared 0/S) 
InstaU options«02 CEdited MSL) 

Options«01 (Build iiithout 0/S sector since It was 

already created by CTI.) 

When END appears^ HIVS is Installed. 



3.3 liiniLUlXSIill 

Deadstart fros? the NOS Dual State deadstart tape# using the 
deadstart tape which is to be installed* Choose the '0* 
option on the first display* for operator Intervention* Then 
choose the 'H* option on the next display to see the hardvfare 
parameters. Enter CM«10COO. Optional lyt the »P« display may 
be selected to choose a CHROECK* (C^RDC14 contains the CANCDD 
S2 configuration* CHRDCK6 contains the ARHOPS S2 
configuration*) Hit carriage return. The system »#ill 
di spl ay : 

ENTER LOCATION 

OF nSl/HiyS DEVICE 

Enter the information for the same disk where HIVS was 
Installed previous I ys 

Channel «xx 
Equi pf?ient=xx 
Unl t«xx 

After the systein is deadstartedf enter the following 
coniniands i 

X.DIS. 

COHHON, SYSTEM. 
IN$TALL#SYST£M#EOxx. 

NOTE! XX is the EST ordinal of the disk where the deadstart 
sector is to be Installed; this Is the same disk where HIVS 
was Installed previously. 
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3.4 k£lM££-£IL£S 

The iOAOPF tapes* which are NT* 0«P€f f«SIf and L8»KL* 
contain the NQS/VE operating system source and binaries* tools 
to assemble and link the operating system* and various other 
f i les. 

Deadstart from the tilsi< upon which the NOS Dual State 
systep was Installed and LOADPF the files to the desired user 
number. 

Check the indirect access file CMOSl to make sure It 
reflects the h^tt^nzTB configurations 

*RELGADCH«x# x should be an empty channel. 

*DISKCH«yl*y2« NOS cannot use channel yl or y2 with Dual 

State active. 

'»=SyST*DISKyz'»=ON. 2 can only be through 3. 

<Unit z on channel yl or y2 iiaJQDfii appear 
In the NOS CNRDECK or EST.) 



3.5 ailM£.y£-fiyAL-.SIlI£ 

After the NDS Dual State system has been deadstarted* and 
the Dual State execution environment has been Installed* 
NOS/VE is brought up by entering the following console 

command! 
X.yPHYVE(CAT*c) 

where? c is the user number in which the execution 
environment K*as installed. Enter K#n. (n * the control 
point number of the UPMYVE job) to see the NOS/VE display. 
K.+BYEVE* followed by K.*ENDRUN. will terminate NOS/VE. 
For further information regarding the operation and execution 
of this environment refer to the S2 Machine Usage Document. 
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4*0 NOS/VE HARDWARE REGRESSION TESTING 



4 * liQS£M£-lii£Mi££-.E££££^lIi]M^I£SIllii 



4.1 IMEJOOiiaiQ!! 

The verification currently performed on NOS/VE systems 
consists of the followings 

1) running the simulator test input contained on file 
VQITSTS until visual examination of the output from this 
test warrants that further testing should be performed* 
and 

2) running the S2 Regression Test Sequence* as outlined in 
the following sections* on the hardware. 



4.2 SZ.£££££SSIQM«I£SII 



4.2.1 TEST8AH 

TESTBAH Is a file containing the statements necessary to 
execute all of the BAH test cases supplied by W. V. Mahal. 
These procedures exercise various portions of the basic access 
method* and are used to show some level of confidence that BAH 
works as well as it has previously. The command sequence 
fo I lows J 



LOGIN USER = DEV N AHE«T€STBAIi 

LIU*U$€R={D£Vl*NV€)*PA«OeVlX* A=NOTUSED*PR«NOTUS£D 

GET*SYSLI8*SYSLIB***NVE*B56 

G£T*CYBILIB*CYBIILB***NVE*B56 

SET.OBJECT.LIST ADO=SYSLIB 

EXECUTE*, ***BA«TEST 

TESl 

TES2 

TES3 

TES4 

TES5 

TES6 

TES7 

TESe 

TES9 
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4.C NQS/VE HAROyARE REGRESSION TESTING 
4«2«1 TEST8AH 



TESIO 

TESll 

TES13 

TES14 

TESI5 

TES16 

TES20 

8AHST0P 

GET>SC1180,SCL18C,,#NV£#B60 

SU8HIT,SCL180 

JHEXIT 



4,2.2 joei 

J081 is a fife containing tlie NOS/Vf conimands Nhich stage a 
CI object file froni the 170 side to the 180 side* convert this 
file to an II library file* and replace the II library on the 
170 side* It tests the following NOS/VE features* 

I INK. USER comiPand 

GETPf 860 

CITOII conversion 

Object Library Generator 

Display Library Information 

REPLACE 856 

JHEXIT 

The command sequence follows: 



LOGIN USER«DEV NAH€«JOB 

LIU*USER«(D£Vl*NVE)#PA«DEVlXvA«NOTUSED*PR»NOTUS£D 

G€T*CITEXT180fCYBILG0***NVE>B60 

EXECUT£*,»CIT£XT180#IITEXT180«,*#CIT0II 

EXECUTE***,, COL 

A0D*F«IITEXT180 

OIS*ON=ALL 

GENERATE*LI8RARY«LIBRARY180 

QUIT 

REPLACE*LIBRARY180*CYBIILB***NVE*8 56 

G£T*J0B2*J062***NVE*B6C 

SUBMIT*J082 

JHEXIT 
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4«2,3 JDB2 



4,2,3 J0B2 

J0B2 is a file containing the NOS/VE coroisands which stage 
an II library and a CI user job object file frosi the 170 side 
to the 180 side* convert the CI user job object file to an II 
object file* and then load Bf\4 execute this user job with the 
library* It then stages the lOADMAP back to the 170 side to 
be printed, J0B2 tests the following NOS/VE features* 

LINK^USER command 

S€T_OBJ£CT_LIST cci«»and 

SET.PROGRAM^OPTIONS coroaiand 

GETPF B56 

6ETPF 860 

CITOIl conversion 

load/Execute User Program -*- Library 

JHRQUTE CI 80 pr int fi I e 

JHEXIT 

The CGinmand sequence followss 



lOGIN USER=DEV NAH£«J0B2 

LIU,US£R»(D£Vl»NV€)#PA*DEVlX#A«NOTySED,PR«NOTUS£D 

G£TfNEyLI8RARY,CY8IILB#,,NVEf B56 

SET.OBJECT.LIST,ADD«NEWLIBRARY 

S£T.PRQGRAH_OPTIONS#MO«(BLOCK*ENTRY_POINTf XREF» SEGMENT) »•♦. <* 

TERMINATION.ERRQR^LEVEL^FATAL 

G€ T» X PETES T,XPETEST,f>NVE# 8 60 

EXECUTE##«XPET£ST,lGQ»##fCITaiI 

EXECUTE IGO 

JHROUTE^HOTUSEOvLQADMAPfPR 

GET,CYBIlIB#CYBIIlB#*fNVEfB56 

SE T.O B J ECT.L I ST* DELETE* ALL 

SET^PROGRAM^OPTIONSf T£RMINATION_ERROR.L£VEL»ERROR 

EXECUTE LGO 

JMROUTE#NOTUSED*LOAD«AP*PR 

GET,TESTBAHjT£STfiAM,*,NVEfB60 

SUBr^IT,TEST8AM 

JMEXIT 



4 • 3 S£_g££E£lSIQM-I£SI-i£2y£!ia£ 

1) Hount the disk labeled ♦•DAHL-Large sector" on 844 Unit 
0. Other disks will not work* 

2) Deadstart A170 NOS: 

Set the deadstart panel to disk deadstart froniJ 

CH«1 
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UNIT«41 

yORO 13«0006 

Push deadstart button* 

- Select *0* display. 
~ Select *H* display* 

- Enter CH=10CCG 

- Hit carriage return. 
~ Enter date/tliRe* 

31 If necessary:* ypdate the INT2 catalog and load the 
latest system files into the INTl catalog! 

- Hoynt tlie IHTl and INT2 catalog OUHPPF tapes. 

- X.DIS. 
USERflNTlflNTlX. 

SES.UPCATS <INTl=tPul> <INT2«tpy2> <SYSEOIT> 
Hit «." to go into AUTO mode. 
DROP. 
The SES.UPCATS procedure works bs follows? 

a) Updates the INT2 catalog by retrieving the "fast 
files" fCHIMAGEf PPIHAGE, RGIHAGE) and CYBIIIB 
frofi! the INTl catalog ^r\6 by loading selected 
files from the OUHPPf tape mounted on the unit 
specified by the "INT2** parameter. This parameter 
iil^^ be specified for the INT2 catalog to be 
updated* 

b) LOAOPE's the latest systea^ into the INTl catalog 
from the DUHPPE tape mounted on the unit specified 
by the "INTl" parameter (defaults to "50"). 

c) SYSEDIT's the A170 Remote Host and Interactive 
binaries if the "SYSEOIT" keyword is specified. 

4) Bring yp dual stateJ 

X.UPHYVE(CAT«INT1) 

K,n. (where "n" is the UPHYVE control point) 

5) Test if paging I/O is workings 

K. DECLARE P POINTER. 

K.SHOPEH P. 

K,CM P /*1234/*. 

K.MMWMP P. 

-> Disk unit light should flash on 844 Unit C* 

K.DM P 100. 

-> If system is hung at this point then paging is 

not working. 

K.SMCLOSE P. 

6) Bring up A17C Remote Host and Interactive: 

TAFNVE. 

7) Bring up C170 Remote Host: 
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9) T€st Inpyt file route / Job exit / output file route? 

X.DIS, 

USER^INTlflNTlX, 

GET,TEST8AM,JOei#J082. 

ROUTEfTESTBAH*DC«LPfFC«RH. 

ROUT£,JOBl#DC«LP#i=C«RH» 

NOTES J082 uses the output of J081 in its executionl 
hence J0B2 cannot be ROUTE'd until JOBl finishes. To 
deterfPlne when J082 Is finished? 

- Hit ***** key to return to K-dlsplay, 

The JOBl dayfile wlil be displayed as the job Is 
running. yhen the system has executed the JHEXIT 
statements J081 has finished. The 40B1 dayfUe will 
then be staged back to the 170 side to be printed. To 
print f i I es* do s 

- Hake sure the printer is on ti.e* the START light 
is fit). 

- F0RH32»TM. 
0M32. 

CThe day files of the TEST8AM and J0B2 jobs will also be 
printed when these jobs finish*) 
Now JQe2 can be submitteds 

- Hit «*" key to return to DIS, 

- R0yTE>4 082f DC«LP»FC*RH. 
DROP. 

The JQB2 dayfile will be displayed as it Is running. 
yhen all Jobs have finished executing and their 
dayfiles have printed^ then NQS/VE and Remote Host tnay 
be terminated by doing the following: 

2. STOP. (bring down TAFHVEI 

K.*8Y€V£. 
When the K-display displays the message that NOS/VE has 
terminated* type! 

K.+ENORUN. 

10) Bring down A 170 NOSs 

A6. 

CHECKPOINT SYSTEM. 

E»H. (make sure that all checkpoints complete) 

STEP. 
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4.<t THE CnNFIDENCE TESTS 



^.^ ia£-£M£ia£i££-I£aii 

The Confidence testbase contains a set of tests which are 

to be run after each build. These tests are created by the 

GENTEST procedure* This procedure MUST be rerun after any 
change to OSLRI or the CI CYBIL compiler* The GENTEST 

procedure is designed to be run on S/N lOlj but can be run on 
the S2. 



4 . 5 IIQi£II2£tia£-IIiI-Siiy£-IliSI£y£IiQMS 

Do this setup procedure when the 0SIRI> the CI CYBIL 
coifipiler* or the confidence testbase changes. The GENTEST 
procedure may be run on the NOS state of the CYBER 180 or on 
any NOS system? with the fastest CI CYBIL coinpller* OSLPI# and 
the confidence testbase PLCCONFPD* 



4,5«1 FILES NEEDED TO RUN THE SETUP CONFIDENCE PROCEDURES 

To run the confidence test setup procedures the following 
f I les are needed J 

CYeiLI/UN*INTl 
GSLPI/UN«INT1 
C0NFPL/UN*INT1 
CYBILC/UN»0€V1 



4. 5,2 RUN ON A NONE CYBER 180 

1* Login to the same user as the test are to be run under on 

CYBER 16C. 
2. Enter SFS> INTl.GENTEST ( 8A001 .. GENC VRT) 

<See section on GENTEST for more details.) 
The test will generate a set of Xflles containing the 
binary file for each job# also the CYBER 180 Job will 
be appended to the 180 load file(L0180), If it is A170 
and 180 interacting test the jobs will be appended to 
A170 load fi le(LD170). 
3* Dump the files to tape* use the SES.OUMPPF 
procedure* 

You will then be ready to run the test on the CYBER 180 
after loading the dump tape. 
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4.5,3 RUNNING ON A CYBER 180 WITH NOS/VE UP 

After Icging In to the user which the testbase is to be run 
under do the followings 

SES#INT1.GENT£ST (BAOOl. .GENCVRT) CHARQFF 

<See section on GENTEST for more details.) 



4 . 6 CfiM£IMM££-I£SI-.Q£££AIfi£-IBH£ilCIIIlll5 



1* Oeadstart the Dual State NOS system. 

2. Load files into the INTl catalog* if necessaryJ 

ysn*<tape un i t>*'»ysnnafn€»*. 

x.di s* 

user* I ntl# in tlx. 

ENTER 
reQuest#dump>nt*d«pe#f«si#lb«kl #po«r#ysn«*»vsnnam»«« 
I oadpf . 
drop. 

OR ENTER ican be done from a terminal also) 
sesf i ntl. I oadpf vsn"'*vsnnafn'* 

3. Bring up NAM. 

4. tog I nf Intl* intlx. 

5. Bring up VE and IRHF. 

6. Run 180 tests( from terminal ). 

SES.LOTEST 

(See section on LOTEST for more details.) 

7. To get 170 listings. 

on 32. 
Ecrfn32f * 
8* To get 180 listings. 
on32. 
Form32# tm. 



4,7 CQM£IDiliC£-.I£SIMl£«££I3££fiiiS£S 



4.7.1 GENTEST 

This procedure will generate a set of A170 and/or C180 load 
files fronts a testbase program library (PL). The default PL is 

the confidence testbase on UN=INT1. 
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The forffat for GENTEST Is as foHowiogi 

SESflNTl.GENTEST test « <t€st_nanie> 

C base « <flle_name> 1 

C Idl70 « <f I le_narpe> 3 

C Idl80 * <f i l8_naflrae> 3 

C uo « <ys€r^name> 3 

C Ic » <leadlng_character> 3 

I norun 3 

I char off 3 

test * deck 5 d I t J m s The test which will be 
generated front the base PI. This parameter is 
required for running of this procedure. 

bass } I \ pi S b : The file name containing the 
confidence testbase. The default is the file naipe of 

CONFPl. 

Idl70 J 17 s The file to get the 170 and 180 
interacting tests. The default file name Is 10170. 

IdlSO 5 18 J The file to get the 180 tests. The 
default file name is 10180. 

yn 8 The user name which contains the CONFPl file. 
The default is the owner of the procedure* 

Ic ! The leading character of the confidence testbase 
PL. The default is a /« 

norun J nr J This keyword when used will create a 
load file on the ID17C file only. The default is not 

to use this parafDeter* 

charoff ' choff » This keyword when used will run the 
tests. These keyword when used without the NORUN 
keyword should only be used when on a Dual State NCS 
systen? and NOS/VE Is up. The default Is not to use 
this parameter* 

Ex amp I €S 



SES^INTl.GENTEST ( BAOOl .. GENCVRT) 

(This will cause all the A170 jobs to be run and the 
€180 jobs to be saved on the ID180 file. Also the 
A170 and C180 interacting tests to be saved on the 
LD170 file.) 
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4,0 NOS/Ve HARDWARE REGRESSION TESTING 
4,7.1 GEMTEST 



SESf INT1,G£NTEST ( 8AC01..GENCVRT ) CHAROEF 

<Thls will generate the complete testbase creating 
ttie A170 job which ui It route In a C180 job when the 
supporting binaries are created* This exafiiple will 
only work if running on a dual state NOS system and 
NOS/VE are up» ) 

S£S#INT1,6ENTEST < BAOOl . . 6ENCVRT ) CHAROFF HORUN 

(This will generate only the LD170 load file for the 
lOTEST procedure* The A170 part of the test will 
route the C18C job after the supporting binary files 
are created on the dual state NOS system.) 



4.7.2 LOTfST 

This procedure will load a set of tests from two load files 
{ one file containing only C180 jobs and the other file 
containing jobs interacting tests between the A17G and the 
CISC). The procedure has three speeds of loading Tfast* 
norma If and low). It also has the option of reloading all the 
tests as pany times as wanted. 

Forn^at of LDTEST is ^s followss 

SES,INT1.LDTEST C Idl80 « <f i 1 e_naifje> 1 
C Idl70 « <f i le_nafpe> 3 
C speed « <high J normal J low> 1 
i loop « <loop_count> 1 

Idl80 \ 18 : The file containing the CYBER 180 load 
file produced by the GENTEST procedure. Default is 
LD180 on the current user catalog. 

ldl7C S 17 J The file containing the CYBER 170 load 
file produced by the GENTEST procedure. Default is 
LD17C on the current user catalog* 

speed J sp J The speed at which the tests will be 
loaded In to the system. The procedure will only 
test the first letter to get the value. The 
allowable values are F or H for high speeds H or N 
for normal speed* or any other letter for low 
speed. The default is normal speed. 

loop S Ip J The number of times the complete 
testbase will be loaded into the system. The 
default is only one set of tests* 
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4,C NOS/VE HARDWARE REGRESSION TESTING 
4.7.2 lOTEST 



Exantple t 

SES.iDTEST 

(This will load one complete set of tests in to the 
systen? with a nornial wait between loading each test 
jofc.J 

SES.IDTEST SP*H tOOP*3 

(This will load three coinplete copies of the 
confidence testbase with a one second rollout between 
loading Jobs. This can be uses to load down the 
system.) 



4 . 8 £i]MI£!in.S£-ItJ£.aQM£ifi£ti££-I£SIMSi 



BAH Tests 

8A001 Issue and verify amp$file and 

amp|get_f I le^attr i butes. 
BA0C4 Issue and verify an^plaet^f i I e^attr ibutes and 

app$fetch for default and snodifled attributes. 
9A023 Verify record movejnentf data integrity and file 

access changes. 

Condition Handler Tests 

CHOOl Test pn?p$ccnt inue_to_cause from specific handler to 

a handler for all systeai conditions. 
CH006 Produce various error codes connected with condition 

handler procedure calls. 
CHOCS Test that the appropriate error code Is generated 

when pmpScont I nue^to^cause is called. 

SCI Tests 

CL016 Test cl p$d€cl ar e_var I afo I e and c I pSreroove.var lab le 

with Test cIpSreiDove.var i abl € for an 

undeclared variable and for a task variable* 
CLG17 Test string length boundaries In 

cIpSdec lar e_var I abl e. 
CL018 Test cl pSdecl ar e.var i abl e dimension boundaries and 

dissension with all command languages. 

Loader Tests 

LDOCl Test static and global pointer initialization. 
LD002 Test XDCL procedure by using large array parameters* 
LD003 Test linking a user task to procedures in task 

serv i ces. 
L0004 Test linking a user task to procedures in task 
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services. 

Remote Host Tests 

RH005 Test replace existing file with no conversion 

I nvo I ved* 
RH006 Test replace existing file with conversion involved. 
RH0Q9 Test replace non-existing file with no conversion 

involved* 
RHOIO Test replace non-existing file with conversion 

involved. 

GENCVRT Set up for remote host tests. 



4 . 9 £fiti£l];^£ti£I.I£SIiAl£-.l!ilMI£l:liM££ 

When nem tests are added or old tests are removed from the 
confidence the following iraintenance is neededs 

This document the new test description must be added or 
the old description must be removed. 

The CONFPL the new deck must be added (see section on 
maintenance of the CONFPL) or the old deck removed. 

The GENTEST procedure must hsve the new deck name added or 
the old deck name removed. See the section on maintenance 
of the GEN TEST procedure. 



4.9.1 CONFPL MAINTENANCE 

yhen adding a new test to the confidence testbase the test 
should have the following call: 

/CALL USER170 after the A170 job card 

/CALL T0180 the last card In the A170 job 

/CALL USER180 after the C180 LOGIN 

The A17G job should NOT have any of the following commands* 

SES. PRINT 

ROUTE^f i le#DC«PR^FC«HR. 

DEFINE* SAVE, or REPLACE 
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4*0 HOS/VE HARDWARE REGRESSION TESTING 
4. 9,1 CONrPL HAINTENANCE 

The SAVE* REPLACE* or DEFINE should be replaced be a 
SESflNTl.SAVEPE call before the /CALL T0180, 



4,9*2 GENTEST PROCEDURE MAINTENANCE 

As neu test are added to the testbase the GENTEST procedure 
is the only procedure which will needed any maintenance. The 
section of the GENTEST procedure which will change is the test 
names* The folio*«ing is lines are those i«hich will be 
changed J 

««BA001RUN» 



«'RHC05SAVE« 



««GENCVRTRUN« 

«n 
The RUN parameter is for any job which has an A170 job to 
produce a file for the C180 test. 

The SAVE parameter is for A170 and C180 interacting tests. 

The n is the count of the last job which can be loaded. 
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i I ) i^ciiMi-liaQsiiliai-f fliffl 



Or i g I n at or .^ ^, . , ^. DATE _^ £.. i^. Target BuiJd 

Code Locations (EiCHecS Modsets) FN* _., UN«, ^^— « 

(Decks In '^SEflyE'* fortrsatl FN«____. _« UN»____.^ ..— ^-. 

( 2 J Co de Oes cr i pt i on Files FN» UH« ««.«-^ « 

(3) Code affects system yser* yes no ^. 

Usage Changes Description Files FN«____^ UN« „ 

Modset Identifier(s) . ___, , ^ . , _. , .. , ^. 

Code Destination (if Qi^l NOSVEPL) s Pt* ^, ^. ^. , ._. 

He¥ Feature i^^ 1 ResubiD ittal C_ 1 Corrective Code C 1 

NOS/VE C^^ 3 A170 NOS C ^1 Dual State C 3 

PSR(s) Answer e d_, _, , ^., , , ^ __. , ___^ . .^««^ ^«. ^ 

£fiMB£MIi-.IO«I^II££lIlQtl 

(4) Installation procedure changes required? C 3 

(4) Dependent upon other feature^ fix# or tool? C_ 3 

(4) Documentation changes required? C 3 

(4) OSIPI or Internal Interface changes required? C^ 3 

Hodule{s) to be recompiled ^. _^ ^. «.«.^ ««« 

Has this code been tested? yes _. 



(4) no 



(1) Use right margin of form if more space needed. More forms 
are on FN « XMITIO UN = DEVI. 

(2) Attach copy of description file to form (both 14 7/8 by !!)• 
Format ist #HOOS ET.IDENTIFIER (or NEW.OECK^NAME ) (upper case) 

Descriptive text which describes code content 
**D€CK_MQDIFIEO (or NE W.OECK.NAME ) (upper case) 

(3) Indicate whether this code Implements changes that will affect 
a system user. Specify the location of the file containing 
descriptive text describing j^fijj the user is affected* 

Attach copy of this file to form (both 14 7/8 by ID* 

(4) If any of the above are checked* then explain below* 



Code Reviewer Approval 
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Request Nuro ber ^_. 

Sfi£IMiE£-£iJill££-E£iy£SI 

Reqyestor^.. „_. _. , , DATE L^^^L - PSR Number . . _. 

Configuration _^^^, Target Entry Date ___/ £ 

NOS System \ \ Integration J ? Stand-alone \ X 

^ + Catalog -i— ^ + NOS/VE +— — •♦■ 

InstaHatior J \ Product Set J \ S2 Prototype % J 

Procedures ^^- + •»• -♦• Closed Shop + — — • + 

SES 3 J A170 NOS J I Dual State X \ 

Tools +~ + Systefj} ^ + System ^ -+ 

Il££«C£.£BOBi£i«.S£IMfi^£Iil£JD 

^ + +. 4 4 .4. 

Critical Fix \ J Hajor PSR \ \ Other S 

+-. + + — «..-.+ 4..— —4. 

G£iC£I£IIOM«0£«atJ^i££ 

Modset IdentifierCs ) , . , ^. ^, „_. 

DecKts) Modified , , . 

{ i ncl ude all 

con?fnon d ecks ) . , , , , . „. _. ^.^ ^ -«-«..^^ 

l2£Saai£IiQ!i.Q£«££Q£L£a>Mi!^i^-£Il£i2 



Approved By 



82 
07/29/81 



The purpose of tfiis for^ is to initiate a mini-feuild of the 
requested changes into the current build level. The scope of 
the changes requested and the impacts of waking these changes 
must be ad€<?uately described. This is the only way to make 
changes to a system after the feature code cutoff for that 
build has occurred. 

ESSil£SiS£» Naise of the person submitting the change* 
DjtS' Date of the request. 
£SS«MMliiJ£» Number of PSR being fixed. 

i£ti-iM-5lSiSlJ Change affects the closed shop NOS system. 
10i£a£lii50-£lllli2a' a correction is necessary to the IHT1# 
IHT2f DEV1# or A170INT catalogCs). 

ItmdzlLan&^liQlllt^ Change affects only the Virtual State 
execution of NOS/VE. 

iQSilllalliSa ££fi££iiUi:£52 a correction to the existing 

Installation Procedures is necessary Cie. such as moving a 

iBodule to a different library) 

££SdM£i«.S£t' Change affects an assembler or compiler. 

i2-££i2ifiil££«£lSS£d^Silil£'* Change Is necessary to the syste^Cs) 

provided in the S2 lab. 

i£S-IlJXiiS' Some change is necessary to the SES tools used to 

generate systeiBs (ie. Linker* loader* Simulator* etc.). 

Ai2fi-MQl«ilSi£l* A change Is required to the A170 Version of 

the NOS operating systew* 

Cyji-SiatJ-SlSl^is Change affects the Dual State software. 

L£iii£ai-.£iii* Fixes a problem which cannot be avoided either 

operationally* or progr smirked around. 

MJJ5£-£S£' A serious problem for which a PSR exists and Is a 

considerable nuisance to system users* 

Qli2££* Fixes to nuisance* or time wasting problems. 

Mfli!S£i-ISl£Giifi££S» Name of the modset<s) which need to be 
added to the affected software. 

OS£]S£«-.-Bfiili£i£il* Name(s) of module(s) which require 
r ecompi I ati on or assembly as a result of this change. 

U£S££i£tli20-i2f-.££SJ2l5ffi* A description of the severity of the 
problem being fixed* and the scope of the changes caused by 
integrating this change* 

A£fi£aiJl2 Authorization signature for the change* currently 
requires T.C. McGee approval for NOS/VE* and J.M. Graff lus 
approval for A170 NOS. 
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; NQS/VE JNOS A17C 1 S/BId Cy| ? Start J Feature ! PSR I Complete S Xmit to ! Return I Complete 
I Build I8uild t Freeze 1 Build I Code ! Code J Build J SV10I>S» J from I BCR 
S J I Interfaces? J Cutoff J Cutoff I I TTOFAC I SVIOPS I 

+- , + , +-- 4. : 4 4..««.. •+ — ., , ^4.^— «+ — ^^— 4.—, •«^— 

111 J (0/S) J J J lO/S) I t t 

I J 4 J - ; 4/25 J - I 4/25 J 5/1 I 5/8 I 6/2 I 6/4 

+, «,^^+ , , 4. , + , , 4.. — ^ . +. , ^ + ^. »4. ™.^«^+.« »,« 

SI! J 6/3 ! 6/10 I 6/24 J 7/4 I 7/9 J 7/14 I - S 7/14 

+- *.»- - 4. ^^+ , 4. f. + ^ , — ,«^ 4. —«. 4. «^ — +. « — . — ^ 

III J CO/S) J I ! (Q/S) S J 

I 15 I - I 6/16 I ~ I 6/16 I 6/20 I 6/23 I 7/10 ! 7/14 

III ! (C/S) ? I I <Q/S) S I I 

1 I 6 I - I 7/14 J - J 7/14 J 7/18 J 7/21 S 8/7 J 8/12 

4. , , . +. «. ««4 4.. —4.-, 4.^^—, 4.««««*««— «4.— «^««-««4.««.« «^«4.^— ^««^-.« 

I J I J 7/16 I 7/23 J 8/6 J 8/18 J 8/21 J 8/26 S - J 8/26 

4 , —4 -, 4 ^. . 4 4 4. -, 4. «. -^«4. , -4. ^«««^4.«»«, . ^« 

III J CO/S) I I I (O/S) I I I 

J J 6a I - I 8/18 I - I 8/18 J 8/22 J - J -- J 8/27 

4.-, 4 ^ 4«, 4 . 4.,_. . 4..^ . 4.«. , ^, 4—^^— ^•«.^4.«, «4^ «»«•« 

I K I I 8/28 5 9/4 I 9/18 I 9/29 J 10/2 I 10/7 S - J 10/7 

4...«.-^ 4. —4. . . 4 .— . 4.-«-™.«,— 4.— ■••-...-..« 4. ..-^».«-^«.«-.« 4..-^ «.«««««.-4.»«-, , «.4^. , _ 

I L I I 10/9 I 10/16 I 10/30 I 11/3 J 11/5 J 11/11 I - I 11/11 

+ ■■ 4 + ' + + -' ~— 4. 4.. -4— — ^ 4.-— —4. . «- 

I H I I 11/12 I 11/19 ! 12/2 1 12/12 I 12/16 J 12/19 J - J 12/19 
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4. ,-- — , 4..^: , «.- — «^ — . , — , «-. . — , 4. ««-.^«, — «, — _. ™«— «-^«^™^^ 

I USER } J ; 

; NUMBERS *, FILENAHECS) J FUNCTION 1 VERSION/FREQUENCY OF UPDATE 

X ___ -_,i_ ______ J, ^_>»__^___^i_>__.^ ».>__. A, _>__i.__^.i-- ■ „_<i___,, ,..„ A. _i ._ _ _.^ - 


I IHTl J MOSVEPl I HADIFY program library • Matches the level of system 
' DEVI J 1 of Virtual State code * binaries contained In same 
« * 1 1 catalog* Updated on periodic 

* * ' * scheduled basis* 

• INTl ; OSLPI \ HADIFY program library • Matches the level of system 
1 DEVI » I of NOS/VE Program 1 binaries contained In ssme 

; S S Interface decks* 1 catalog* Updated once for 
« t * \ each build cycle* 

X _>_■_—<_-.»-»» -»_ _Jt'.B._<_ _-•»__.__.•_ _____i__^«....___^_«..i»_a___._»__—:_ ,^-mmmmt^i^,mmmmJ^-wm,.^:mimmm,'m^^>mm-mm.m^m>-,m-mmmrt^mm-mmam,m::^mttm.mm-mm-tm-mmmr,»'am-mt^>'mm.mmrim 


\ INTl \ VE170PI : MAOIFY prografP library I Hatches the level of systew 
« DEVI ' J of NOS code which J binaries contained in sawe 

* 1 S supports NOS/VE* » catalog* Updated on 

* I * * periodic scheduled basis* 

X ___,_,_,___ —1 __,.,___ A _,_._ _. . ■«-_ ~ _,__--_.__. _i _. X _____•>_,_ _i_ ,.,,___ ' ■ _ .. ^ _ ^^ _ i_ _ X .«- ■- ..... .. .._... 


S A170INT J A1700PL \ HQDIFY program library I Updated on a scheduled basis* 
J LIBRARY \ OPl S which matches NOS 1 <CPU^TR which supports NOS/VE 
\ J J system level for S2* \ is on VE170PL and Q^t 
5 J \ (Installed on FMO J on this PLK 
! J I unit 43). ; 

X__«»_____«.ii»_X_-._»«-.^__.__,__^__,—n^X_i— .«»«._-.____,_ ______ ___ - - -' - 4. _-.,__ _ _.____.,. ■■ - ■■ _ _ 


J INT2/INT1 \ PROCLIB J Command Language \ Matches the level of system 

\ \ « (Documented in I catalog^ and accesses the 

* « « Integration Proced- * appropriate build tool 

J « * ures Notebook), J versions* Scheduled updates* 

+ ^^ , + . ^.^, «^ ^ «, , . «« 

J INTl * NOSLIST J Contains compilation/ * Matches the level of system 

• DEVI ; ; assembly listings of J binaries contained in the 
' « t all Virtual State « same catalog* 

« \ \ code* Accessed via * 
5 I * LISTNVE procedure* ! 


S INTl J MTRLC8>EI£LC8# J Linker directives files t Matches the level of 

I DEVI J EILCBfSTSLCB S for monitor* J system binaries contained 

* I LIBLCB « error interface* ! In the same catalog* 

• * i task services* and J EI is built using the 

t * * user modules * BLOEI procedure* while 
J 1 ! respectively* J NVEBILD is used for EIE* 

X__ _________ X_i __--__._ ,.., _,,. _ i_ ___ X _______ ' - _ _ i_ ^_ __i - ' <_ J' - -_,_______ ' ,_ _ 


J INTl J NEWDKPL J Meaningless Madlfy J Never* disappears when SCU 
1 DEVI t « program library « conversion is complete* 

I J I subst 1 tute f or J 

* i 1 as an al tern ate * 

* 1 • base when using ! 
1 ' J Integration compilation J 
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• J . procedures* ! 


J INT2/IHT1 I MAP<offset>K \ Contains link laap of 1 Each Velink of a Dual 

; OFVl S t Dual State system 1 State system. 

' i J created* where MAPOK J 

1 J 5 is a standalone NOS/VE 1 

\ J J system and liAP256K ? 

1 J ; is a 256K NOS Dual J 

i J 1 state system. 1 


• DE¥1 I J commands for a . content changes* 

* J * batch mode test S 
I 1 of the NOS/V€ \ 

i • J system* I 

,1, _ _ i.L ^ a_ _ _ >_ J-- ^ » .^ - - _._ jm _._ _ _ _ i_ _ _ _ 1. _ _ _ i_ _ __ 1. _ __ _ _ ^ _. ' _ .« __•__«___ i_ a _,>,___•__ _> ■ ■ ... 


; INTl I LOR<offset>K J Contains VE generator ? As required by system 
* DEVI * ! directives for Dual * content or structure 
J I J State offset loads* 1 changes* 


t DEVI ; KEYOESC I Contains Keypoint 5 Non-standardf updated 

J J 1 descriptions for J upon development's request* 

• t * the Keypoint report J 

J ! J program XXI^ITKEY* 1 
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I INTl ; XLHHTR *, Object text file J Each recompi 1 at i on of a 
J DEVI J » of modules which » monitor mode module* 
* ' \ execute in monitor S 
I J 'mode* * 

Xl__> ___ _ _■•. .„,_,_ _ ,_ _ _. _ ±. ,_ _ - _ ... _ , .„, .. MM ,_ ,„< » ■ ■ ... _ _ _ ,_ .■,«...„ -. . 


S INTl 1 XLJ11F,XLJ12F \ Object text files 1 Each recompHation of 

J DEVI 1 XLJ13F#XLJ1FF I of task services J a task services 

« » * modules which run in \ module within these libraries* 

\ 1 « job mode with 1 

1 S .ring attributes J 

I I I 11F,12F,13F and } 

» I J IFF respectively* t 

J INTl J XOL€#XSCLf J Object text files 5 Each recompi 1 at ion of 
; DEVI J XLLHCII ! of the Object Library J these utilities* 

* I * Generator* System J 
« ! * Command Language* « 
1 S » and Object Text J 
J J J converter* * 

I INTl J XUCNTLfXUTEST* I Object text files J Each recompi 1 at ion of 
! DEVI J XUSORT*xyUXERl, J of user test J these tests 
J 1 XUUTL*XUVLEX* 1 programs added } 
J J XUVLEX2 J to the system* J 

4. 4. , . : 4-^ ■ ■ -1— ^ — ^ -^ — ■ ™ 

I INTl ; MTRXHDR* I Header files which J Each Velink of the 
J DEVI J STSXHDR* J n^me the monitor* * system* 
J J EIEXHDR* ! task services* and * 

* * Jerr or interface J 
\ 1 * segment f i 1 es* 1 
! 1 ! produced by * 
J J \ VELINK* J 


1 INTl S HTRXOST* J Outboard symbol J Each Velink of the 
1 DEVI ; STSXOST* J table files for J system. 

* • * services* and ' 
S ! Jerrorinterface • 
J ; I produced by * 
J J S VELINK. S 


I INTl J STSXIOI thru ? The task services J Each Velink of the 
J DEVI ; STSX118 J segment files 1 system* 
1 ! 1 produced by J 
J I : VELINK* J 

JLam-m^^mm-mf^^mm^-m^mmm^m. .*. «.s.a. .• a.a» <_ a... a..M<a> a>«ai a. «».«• 4. aa aa ^-aso aa ..a» a»a. aaa» _a»a>._ aaaa^a «... a_a.a» 4.... .>'...a».a.a.aa a>.a»a»a..>..a>.a»oa»aa a.s.'a. a»a»a» a.<aa.»a»a»aa.i»._.»aBa» 


J INTl J MTRXlOl thru S The monitor J Each Velink of the 
J DEVI 1 HTRX105 J segment files I system* 
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1 t J VELIHK. J 

^ , + ^ «-^ -., . — ^ — 4. » . , — ^ «, — ^ — ««. — ^ « 

1 INTl t EIEXlOl thru \ The error inter- J €ach Velink of a 
1 OEVl 1 eiEXlOa ; face segment I Dual State system* 
J * J f i les produced • 
1 J I by VELINK. 1 


5 INTl 1 XCPUMTR J A170 HOS CPU \ Each recoropi 1 at i on due to 
t DEVI J J Monitor module J wodset corrections or 
1 t 1 binaries* J changes to the base A170 
J • J 1 NOS level system. 

I INT2/INT1 S lG8<offset>K S The Virtual Envir- ! Each VELINK/VEGEN 
J DEVI S * oninent file pro- J of the system. 
J J r duced by VEGEN. 

S INT2/INT1 J CKPT J The checkpoint file J Each batch mode slmul- 
J DEVI 1 J from the last 1 ation of NQS/VE* 
t J 'simulation run as a J 
i t ' result of running J 
\ S 1 the VQLTST3 test 


J IHT2/INT1 J CKPTO thru J The simulated disk J Each batch mode simul- 
! DEVI 1 CKPT2 J files produced ? ation of NOS/VE. 
\ I J during the batch 5 
t ' J mode simulation ! 

« « I run* ; 

+ -—4. -— , , — + , ^. 4. ^ — . . «^ 

J A170INT i NOSTEXT 1 4170 NOS system J Each A170 NOS update* 
' ' I text for current J 

4. — : +, , 1. — , . «: — , «._. — 4. — «- ^ . — . ^. 

J DEVI J XXH7KEY J Program to report J Non-standard ISil 
; J J NOS/VE Keypoints \ utility* 
t t i encountered during * 

* t i a simulation run* I 

+: . +- , — , — , : 4. : «. — . . — ^ — +-..-^«. «.—.„— « ^- 

1 1 1 of NOS/VE deadstart « unsupported* 
I ! ? fi le generator • ? 

! DEVI ; XXDSGEN I Dual State ! Upon demand. 
1 J J deadstar t f i 1 e ! 

t » * generator* 5 

+ + 4. 4. , , , . ^ , — 

1 DEVI ; XIOST#XIDSK# J CYBER 180 PPU J Upon demand. 
J ; XIOSPfXIHLP* 5 programs* ? 
5 J XIRES J J 


J INT2/INT1 J TP<offset>K \ Dual State J Each time a new 
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deadstart file is 
Qcnerated (upon 
demand) • 
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BUILD N HELPFUL HINTS 



This paper describes helpful hints on how to use build N of 
NOS/VE. It is Intended to supplement* rather than to replace* the 
standard NOS/VE documentation* If you have any qustions or 
suggestions* please see Ton? HcGee or Geoff Barrett* Appendix A 
lists baclcground documents and how to obtain them* 

To obtain additional copies of this document while running on 
at Arden Hills* please types 

€ET*NHIHTS/yN*GSB 
S€S*FORMAT NHINTS TXTFORH 

Date Changes 

12/22/80 Revisions for NOS/VE Phase C 

2/12/81 Additional revisions for NOS/VE Phase C 

6/9/81 Pevisions for NOS/VE Build N 

6/19/81 Additional revisions for NOS/VE Build N 
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El.O HAJOR CHARACTERISTICS OF THIS BUILD 



El .0 Mii]I-£Hi£i£Ii£15II£i«D£-IMll-iyiLfi 



The CYBIL/CI cofTspHer has been modified to support the SIS 
cor^f ormance procedure calling se<?u€nce» In conjunction nith 
this change^ the NOS/VE object text (VI. 2) has been revised to 
support building PVAs with a negative byte offset* The result 
of this is that aH HOS/VE object files and object libraries 
produced prior to build N are Incompatible with the build H 
object code utilitiest loader and compilers* Therefore* alt 
users of CYBIL/CI and NOS/VE build N and build must recompile 
their modules with the new compiler and reconvert the object 
files and rebuild their NOS/VE object libraries* All code 
generators should be upgraded to the new object text 
definitions* 

Any attempt to use the previous versions of the object text on 
build N will result in the appropriate processor issuing « 
di agnost I c* 

MOTE! SES tools and the SCITOII and CITOII converters will 
continue to support the non CYBIL/CI Vl*l object 
text* 

00 NOT assign the loader map file to the terminal In interactive 
jobs {i.e*f file ^OUTPUT* or *$OUTPUTn* This will cause a 
systeif! crash* File names are assigned to the map file via 
SET^PROGRAH.OPTICNS* EXECUTE* and PHPSEXECUTE (program 
descr ipt I on ) » 

o Permanent Files now work* NOS/VE permanent files are permanent 
only until a crash or deadstart. 

The files J£DN# SYSLI8 and CY8ILI8 that everyone had to GET from 
the NOS should new be attached as NOS/VE permanent files as 
fo 1 1 owsJ 

ATTACH .USER1*SYSLIB E AMILY^EAMILYl 

ATTACH *USER1*CYBILIB F AMIL Y=E AMIL Yl 

ATTACH •USER1*J£D FAM ILY«FAMILY1 « For editor " 

However users whc use the SETUP* CITOII and COL commands (which 
we strongly recommend) should never have to attach these two 
files* If it Is necessary to do so* be aware that the names 
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€1,0 HAJCR CHARACTERISTICS OF THIS BUIID 



FAHIlYlf USERl «H! be changing to SSYSTEMt SSYSTEH during build J 

0. I 

A temporary procedure is available that will perform several I 

functions that will be handled toy validation and permanent files I 

In the Rl systeni. The procedure is nailed SETUP* and should be « 

called first thing after gaining access to NOS/VE In interactive I 

jobs and i ffijuedi a te I y after the LOGIN cominand in batch Jobs* * 



A parameter has been added to the AHPSQPtN request* See 
♦Program Interface Status - File Management' for further 
inforfl?8tlon* 



Issuing the LOGIN command will cause a permanent file catalog to I 
be created for the current user/family* Oos 5 

LOGIN user«xxx t 



Interactive jobs have family»NVE and batch jobs have 
fami I y«REMOTF* An example? 

LOGIN user^ZZZ 
DEFINE ^lll*k 

For an interactive job creates? 

.111*^ FAMILY«HVE 
For a batch job it creates? 

• ZZZ*A FA^^ILY=R€MOTE 

Note that the current user name may be specified by the SUSER 
construct — as in? 

ATTACH SUSER.A 

LOGIN should be the first command issued in a batch job| 
followed by SETUP. For an interactive job> the first NOS/VE 
command issued should be SETUP since Interactive users login to 

the NCS NAH* 

Job and standard fiies# as documented in the 'Command Interface 
ERS* R€v*8'» are available* 
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£1.0 MAJOR CHARACTERISTICS OF THIS 8UIL0 



For interactive jobs» files INPUT* OUTPUT and COMHANO are 
connected (assigned) to the terminal automat i ca lly for every 
task In a job. The RHP$R€QUEST_TERHINAt request must foe ysed to 
assign files other than COHMANO, INPUT* OUTPUT to a tersiinal 
device. 

o You can cause SCI to output the commands being executed from a 
procedure or include file by doings 

connect.flle $ECHO SOUTPUT 

The NCS/VE editor is available on <B56) file JEDN/un*IFP. The 
editor can be accessed by the EDIT nonstandard coffiwand* If you 
Hant more information about the editor* contact Jack Bohnhoff* 

The REMIND and RETURN cofnmands are available* These commands 
accept NAME rather than FItE REFERENCE parameters! this should 
only present a problem in an SCL procedure* All FMxxx commands 
(like FMRETURN) have been removedJ 

RETURN A 
RETURN {A*B#C) 

Files cannot be returned if they are open. 

o Files iilll be returned at job termination. Files will also be 
closed at task termination. 

The procedure CI P$GET.STNO_INP has been deleted* Procedure 
CLP$PUT_STNO_OUT will be deleted in Build or P. Everyone 
should convert to use BAM* 

o When sharing executable files via permanent files (compilers* 
libraries* etc*) you should make the file an object library 
(via the COt utility)* By sharing object libraries (instead of 
object files) the code Is actually shared among all tasks using 
the library (the library is not copied to another segment but is 
executed d i rect I y) * 

The file(s) specified by the FILE parameter on the EXECUTE 
command may not be object library files* 

The program option PRESET has no effect since the file system 
does not yet support presetting. 
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El.O HAJOR CHARACTERISTICS OF THIS 8UIiD 
El,l NOS/VE USAGE EXAMPLES 



El.l ifili^£.ySi£I«£MI!£L£i 



El.l.l EXECUTING PRGGRAHS 



LIMITATIONS 

- The flle(s) specified by the FILE parameter on the EXECUTE 
coipmand may not be object library files* 

The program option PRESET has no effect since the file system 

does not yet support presetting. ; 

- If you are an interactive user* DO HOT cause the map to be I 
written to the file •OUTPUT* or «$OUTPUT« <SET.PROGRAM.QPTIQHS ! 
or EXECUTE) * doing so will crash the systeffl. J 

PROCESS 

Create an object text file by compiling a program on NOS« Then I 
perform the following steps on NOS/VE J ! 

- Ac<iuir€ any necessary libraries (which are Qsit <iyoted in text 
embedded directives) by elthers 

Attaching them from the system catalog* either explicitly or 
via prolog 

or 
Creating the library file via the object library generator 

or 
Staging the library file from NGS to NOS/VE using the 
G€T_FIL€ comn?and (with 856 conversion mode specified). 

Get the file from NOS and convert the object text file from the 
CI data mapping to II data mapping by executing the CITOII 
comirand. 

- Load and execute the program via the EXECUTE command* specifying 

the necessary libraries with the LIBRARY parameter; 
alternatively SET_08 JECT^L 1ST may be used to include the 
libraries in all subseguent EXECUTE commands* 

Stage the loadmap from NOS/VE to NOS for printing by using 
e i ther ! 

The REPLACE^FILE command with A6 conversion mode specified 
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E1,0 HAJOR CHARACTERISTICS OF THIS BUILO 
El.l.l EXECUTING PROGRAMS 



if running on the simulator. 

or 
The PRINT coffsmand if running on the hardware* 

EXAHPiiS 

The following Is an example comaiand sequence for executing a 
program not requiring any libraries for loading? 

Assuinpt I onss all ipodules to he loaded are contained on the NCS 
permanent file *citxtrs*» 

SETUP JLH JLHX 

CITOII CITXTRS 

EXECUTE CITXTRS PAR AMETER* Vprogram parameters' 

PRINT LOADHAP 

The following Is an example coffimand sequence for executing a 
program requiring libraries for loading? 

Assumptions? the NQS permanent file 'citxtrs* contains object text 
generated by the CY8IL CI compiler. The compiler modules reference 
procedures contained on the user library «myllb« and the CY8IL 
run-time library. These libraries have been generated on NQS/VE 
and saved on NOS* 

SETUP JLN JLNX 

6ET.FIIE MYLIB C«856 

SET.PROGRAn.OPTIONS f1AP_aPTI0NS»{ B#E» Xt S) 

CITOII CITXTRS 

EXECUTE CITXTRS 'program parameters' LI8R ARY«HYLIB 

PRINT LOADHAP 



€1.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 

CL60170 is NOS permanent file name for file containing CI object S 

text for modules to be included in the library. S 

IITEXT180 is NOS/VE local file name for file containing II ! 

object text for modules to be included in the library. • 

LIBRARY180 is NOS/VE local file name for the library being I 

created. S 
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£1*0 MAJOR CHARACTERISTICS OF THIS BUIID 

£1.1«2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 



ILIB170 Is NOS permanent file name for file containing the 
H br ary. 

NOS/VE Job Coffiinands 

SETUP JLN JLNX 

CITOII CLG0170 IITEXTiaO 

COL 

AOO LIBRARY«IITEXT180 

GENERATE tIBR ARY^II BRAR Yl 80 

QUIT 

REPIACE^FIIE LIBRARYiaO ILIB170 C«856 



El, 1.3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 



Notes 

c ILI817C is NOS permanent file name for file containg the old 

I i brary 
LIBRARY180 is NOS/VE Iccal file name for file containing the old 

f I br ary 
CMQD17G Is NOS permanent file name for file containing CI object 

text for the new module 
NEWIIHODULE Is NOS/VE local file nawe for file containing II 

object text for the new module 
NEWLIBRARY is NOS/VE local file name for the library being 

cr eated 
NLI8170 is NOS local file name for new library 

NOS/VE Job Commands 

SETUP JLN JLNX 

GET.FILE LIBRARY180 ILI817C C«B56 

CITOII CH0D170 NEWIIHODULE 

COL 

ADD LI8RARY*LIBRARY180 

REPLACE FILE'NEWIIMODULE 

GENERATE LIBRAR Y«NE WLI8RARY 

QUIT 

REPLACE^FILE NEWLIBRARY NLI8170 C«B56 
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El.O MAUOR CHARACTERISTICS 
€1.1.4 ROUTE AN INPUT FILE 



Of THIS euiiD 
FROH HOS TO NOS/VE 



El. 1.4 ROUTE AN INPUT FIi€ FROH NOS TO HOS/VE 

Running from an Interactive termlnalf enter! 

GET#f i I enaaie. 

ROUTE, fi len8me.fOC«lP»FC*RH. 

The input file which is sent to NQS/VE must be In 6/12 ASCII Cor 
display code subset). The job file must be a single partition NOS 
record containing NOS/VE commands. Huiti partition Input files are 
not supported by NOS/VE so NOS data files used by the prograa? ii?ust 
be obtained through the GET^FILE command. 



El. 1.5 PRINT A NQS/VE FILE 



At NOS/VE job termination the job log wiil be automatically 
returned to NOS. The job log will be appended to the NOS/VE output 
file OUTPUT. NOS/VE print files must be written by BAH as 8/8 
ASCII RT*W. Print files will be converted from 8/8 ASCII RT«W to 
Display Code (64 character set - upper case only) uhen they are 
sent to NOS. Support for ASCII print files <8/12 ASCII) will be 
added at a later build* All NOS/VE output files will appear In the 
NOS output queue (NOS H,0 display) with the name IRHFxxx as a 
banner. In order to route a NOS/VE print file to NOS# the 
foi lowing command must be contained in the NOS/VE job file or be 
entered froir the system console via the K display) 

JMRCUTE* jobnamef f i I ename»PR#REHOTE 

jobnawe - name that the print file will have In the NOS/VE 
output queue. 

filename - name of the local NQS/VE file created by BAM that 
is to be printed. 

PR - specifies that the file is a print file (must always be 
PR). 

RENCTE - name of the NOS/VE family for the print file (inust 
always be REHOTE). 

Example of JMROUTE command* 

JHROUTE,lISTING,LINKMAP,PR,REMOTE. 
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El.O HAJOR CHARACTiRISTICS OF THIS BUIiO 
El,l,5 PRINT A NQS/VE FILE 



The SCI PRINT command can also be used to print files. 5 

See the command ERS for detatis* * 

On the NOS side^ the printer must fee physically and • 
logically en. To logically turn the printer onp under DSD • 
enter s 

0N32, 

F0RH32*TH. ! 
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€2,0 £QllBMI^^IMIl££M£«SI^IilS 



E2 a i£££il.Ifl«MQSZM£-.iM-OUAL.SIM£ 



g2«l*l LOGIN TO NOS/VE 



To initiaHy login to NOS/V£ via TAF> you must cause the first 
login attempt to fail. This can be done by responding to the 
•^FAHILYs*' login proinpt with something likei "AfA^A**. This must fee 
done because the system wlH try to connect the terminal to lAF on 
the first login attempt no matter what is typed* To access TAF do 
the following on the second "FAHILYJ" prompts 

fUser#passwordfTAF 

You can access TAF from lAF by doing "HELIO^TAF" or by answering 
TAF to the system prompt "APPLICATION!"* 



E2*l«2 TERHINAL USAGE 

1) The question mark (?) is the prompt to enter a NQS/VE 
command* Any normal NOS/VE command can now be entered* The 
full ASCII character set# lower or upper case and all special 
characters* can be used* 

2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate* A new NOS/VE Interactive Job can then be started by 
responding to the • APPLICATIONJ • prompt with TAF* 

3) Terminal breaks (control-T and control-P) now work* It Is 
possible to terrrlnate a task or to suspend a task and enter a 
new task to process SCL commands* When a break is entered* the 
options available to the terminal user are: 

R - resume from point of Interruption 

T - terminate taskj n*b* commands running in the job monitor 
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€2.1.2 TERHINAL USAGE 



task Ce.g. COPYf EXECUTE etc. J cannot be terminated* S 

S ~ process SCt commands. To resume execution at the point of • 
interruption use the HCS cofnniand THEXIT C temporary J • I 



E2,1.3 NQS/VE PROGRAH ACCESS TO THE TERHINAL 



1) Interactive NOS/VE jobs are able to obtain terminal input 

through the AMPIGET^NEKT or AHPSGET.P ARTI Al program Interface 
which can be used by both task services and user ring 
programs. Interactive programs which use this interface should 
be able to handle both upper and lower case input In order to 
make them more convenient to use In both 64 and 96 character 
set modes. 



E 2 . 2 £Qlil!MI2.£yM£IICH^ 



$MOD unchanged 

$CHAR unchanged 

SCLOCK unchanged 

IDATE unchanged 

$ FN A HE unchanged 

$ INTEGER unchanged 

$NAHE unchanged 

$CRD unchanged 

$REAL unchanged 

$STRING unchanged 

fSTRLEN unchanged 

SSTRREP unchanged 

SSUBSTR unchanged 

$TIME unchanged 

$VAR unchanged 

$SPECIFIEO unchanged 

$SET. COUNT unchanged 

tVALUE.COUNT unchanged 

SRANGE unchanged 

ICEBUG^HQDE^ON unchanged 

SPARAMETER^LIST unchanged 

IPARAMETER unchanged 
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E2.0 COHHANO INTERFACE STATUS 
E2»2»C«C«0.1 SysteiK Access Ccwmands 



€2*2.0.0.0*1 S^si;ii-A£££S5«£fiifflaaiis 



I INK. USER 

LOGIN 

LOGOUT 



unchanged 
new - ♦! 
new 



*1 A iRaster catalog is created for the user who issues iOGIN 
coiffliand. Nc paranieters are necessary. 



E2.3 MSCyM£»liMlSfl3£!iI 



REQUEST^TERHINAL 



not aval I abi e 



E2.4 FIL£.l!iMA££B£MI 



FILE 
CCPY 

OUHP.FILE 
COfiPARE 



updated to 
unchanged 
unchanged 
unchanged 



Rev 8 ERS 



E2 .5 £££lliE£MI-£iL£«!2A{iiA££I£HI 



^fillJCii^ 


£iilyi 


HCS GET 


unchanged 


HCS REPLACE 


unchanged 


DEFINE 


unchanged 


ATTACH 


unchanged 


PURGE 


unchanged 


CHANGE 


unchanged 


PERMIT 


unchanged 


DELETE.PERMIT 


unchanged 


OEFINE.CATALOG 


unchanged 


PURGE.CATALOG 


unchanged 


DELETE.CATALOG.PERf^IT 


new 


PERMIT.CATALOG 


new 
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E2.5 PERHANEMT FILE HAMA€EH€NT 



eui Id 



Peri?ianent file Program Interface Oeficiencies 



2. 



3, 



In crder to access the NOS/VE permanent files of a yser# a 
waster catalog rnust exist for that yser* At release one time* 
the validation facility will create a master catalog for a user 
when the user Is created. At build N# however^ the validation 
facility does not exist. To circumvent this problem* the LOGIN 
cowhand has been modified to create a master catalog for the 
user feeing logged in* Thus* once a user has logged In it will 
be possible to perform NOS/VE permanent file operations for 
that user* Since a LOGIN command will eventually be required 
for all Jobs# it should be no hardship to include it in jobs 
starting with build N« 



Per manent 
deadstar t* 



files on NOS/VE are only permanent until a NOS/VE 



The WAIT parameter for ATTACH is always treated as if 
PFC$NO„yAIT is specified* 



E 2 * 6 l£L^lIiI£ll£tiIi.AMI2-£EQ££l2ySE5l 



PROC/PROCEND 

SET.COHMANO.LIST 

OISPLAY^COMHAND.LIST 

REPEAT/UNTIL 

WHILF/WHILEND 

OECLARE.VARIABLE 

REMOVE. VARIABLE 

BLOCK/BLOCKEND 

LOOP/LOOPEND 

FOR/FORENO 

IF/ELSEIF/ELSE/IFEND 

CYCLE 

EXIT 

INCLUDE 

COLLECT.TEXT 

DISPLAY.VALUE 

EXIT.PROC 

ACCEPT 

00 

CONNECT.FILE 

DISCONNECT.FILE 

OISPLAY^CGNNECTION 



unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged - ♦! 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

parameter changes 

added status parameter 

new 

new 

new 
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E2.6 SCL STATEMENTS AND PROCEDURES 



change HCS variable 
display HCS variable 

^1 Variables can no longer 
boolean constants. 



unchanged 
unchanged 

be declared with the same nafnes as the 



£2.7 lMII£Aail£-£QI!l3MM 



RESUME 
TERMINATE 



ItatU^ 



new 

new 



£2.8 0fii£a-C0a£-i3AiilI£HAM££ 



llatm 



CREATE.03JECT.II8RARY 

DISPLAY^LIBRARY 

SELECT.DISPLAY^LEVEL 

ADO 

REPLACE 

CO^'BINE 

CREATE.HODULE 

BIND.MODULE 

DEEINE.PROGRAM 

DELETE 

CHANGE 

SATISFY 

REORDER 

GENERATE 

QUIT 

CI to II Conversion 



1) An II object file or library can be displayed using the 
nonstandard command 08JLIST. 
Ex amp I el 

OBJLIST II. OBJECT LISTING 



unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 



Where II. OBJECT is a 
LISTING is the file 
I i st i ng. 



n II object file or object library and 
containing the formatted object text 
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E2*8 OBJECT CODE MAINTENANCE 



2) Users of CREATE. OBJ ECT^L I8RARY and OBJLIST must now get the 
programs to NQS/VE via the following cofRwands prior to their 
execution* 

ATTACH •USERl^SYSLIB FAHILY^FAMILYl 
ATTACH .UStRl*CYBILI8 FAHIi Y^FAMIL Yl 
SETOL A0D«SYSLI8 

The default system prolog used by the SETUP comfliand ellininates 
the necessity of Issuing these coifiirsands * Using SETUP Is the 
recomrr ended approach. 

3) CREATE.08JECT_LI3RARY expects V1.2 of the object text and V0.2 
object libraries. This is incompatible with previous releases* 
All NCS/VE object files and object libraries rpust be 
regenerated. 



€2.9 iiSI£-S£SM£0 
OISPLAY^lO€ 



UPON changed to OUTPUT ~ ♦! 



"^l type » <system » sys \ job> Instead of type * <systeni J account » 

? engineering * statistics * job ! job.st ati st i c> * 

i^JlDiHa - If you print display log output on a line printer* you * 

must use the PRINT <file nafr!e> SHIFT»YFS corojnand or you will get ! 

one I ine per p age. « 



E2.10 £lU.EQilIIM£ 



HCS JMROUTE 



unchanged 



E2.11 £EO££M-U££UIIQIi 



SET.OBJECT^IIST 
SET.PROGRAfl. OPTIONS 



unchanged 
unchanged 
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E2,ll PI^OGRAM EXECUTION 



unchanged 




unchanged - 


♦ 2 


unchanged - 


*1 


unchanged 




unchanged 




unchanged 




unchanged 




new 





OISPIAY.PROGRAH 

EXECUTE 

"name cal 1 •' 

PUSH^OEBUG.HQDE 

POP.OEBUG^MODE 

SeT_DEBU€_HODE 

SET^DEBUG^RING 

TERHINATE^TASK 

*1 MJLQiHia " "name call" works only for SCI procedures unless a 
FILE co!PJ!iand has been issued to specify that the file is an 
object file and the structure is data* The FILE conifnand must 
be reissued every tline the file Is attached or brought over 
from NOS . 

*2 If you are an interactive user# do not specify the values 
•OUTPUT* or «$OUTPUT» for the parameter HAP| doing so will 
crash the systei!!. 



E2U2 ifli.i3i!!lMM£MI 

SUBHIT unchanged 

DISPLAY.JOe.STATUS unchanged 

DROP^^OB unchanged 

PRINT unchanged 

DROP.FILE unchanged 

DISPLAY^PRINT.STATUS unchanged 

E2 ,13 liQ5iii£.£OllMti01.I!l£i£d£tiI£a-AS-£EQ£S 

In this builds several NOS/VE conjmands have been impi einented as 
SCL procedures in order to make the system look more like the final 
version. Users are urged to use these procedures rather than their 
interim counterparts since the interim commands will ultimately be 
wi thdrawn* 

In order to have these procedures available in your job# you 

should use the SETUP command using the default system prolog* The 

procedures will be local files in your job* so name conflicts 

should be avoided* 
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E2.13/1 GET. FILE 



E2.13a GCT.FIIE 



This procedure Is identical to the version documented in the 
NOS/VE ERS except that the default conversion is A6« Me intend to 
change the ERS to use this default as well* 



E2.13.2 REPLACE.FILE 



This procedure is identical to the version documented In the 
NOS/VE ERS except that the default conversion is A6» We intend to 
change the ERS to use this default as well* 



E2a3.3 PRINT 



This procedure is similar to the version documented In the 
NOS/VE ERS except that it returns the local file after routing it 
to NOS* This is a deficiency of the JHROUTE cofBsiand as well. 

In addition* the PRINT command does not add carriage control to 
the file to be printed* if necessary* This can be done by using 
the SHIFT parameter of the command. 

The following is a description of the build N PRINT coronsands 

print f i le«l ist of <f i I e> 
I shif t«<bool ean>3 
Cs tatus«<stat us variable>3 

files This parameter specifies a list of files to be printed. 
These files will be returned after the files are routed 
to the pr inter ♦ 

shift J ss This parameter specifies whether or not carriage 
control characters are to be added to the file. 

Omission mill cause NO to be assumed. 

status? See ERROR HANDLING. 



iui Id H, June 1981 



E2-9 

S2 Ha chine Usage Docufflent 

07/29/81 

E2.C COMMAND INTERFACE STATUS 

£2. 13 ,4 i^^^ll^^m^lzh^^^til * ^^^ 

£2.13*4 CREATe^OBJECT.lIBRARY J COl J 

This procedure Is identical to the version docui!!ented in the J 
NOS/VE ERS except that only the comffland alias COL is available* J 

The following corrmands provide a nonstandard means of performing J 
various frequently performed functions* They will be superceded in • 
subsequent builds by standard commands and capabilities* \ 

£2*14*1 SETUP S 

The purpose of this con?mand Is to provide a "prolog** capability 
for a user* This Is an interim comwand and will be withdrawn when 
the full validation and permanent file capabilities are available* 

Only s single SETUP command should be issued In a batch job or 
terminal session* Any SETUP commands issued after the first will 
fail due to the presence of the LINK. USER command* The SETUP 
command should be the first NOS/VE command issued in an Interactive 
job and should be issued immediately following the LOGIN comasand in 
a batch job* 

setup user«<name> 

password«<n3me> 

I pr olog*<n8me>3 

C system.pr olog«<name>3 

Cf ami I y«<n ame>] 

Cs tatus-<s tatus variable>l 

user I us This parameter specifies the name of the user 
responsible for the processing to be accomplished* 

password I pwJ This parameter specifies the user password* 

The password together with the user and family name will 
be used to construct a link.user command* This llnk.user 
command will be processed as a part of the setup 

command* 

prolog » p: This parameter specifies the name of a NOS file 
which will be copied to the current session environment 
(get operation)* This file will then be interpreted 
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tjsins the include capability* Owission will cause a file 
name of PROLOG to be used* 

sys tefl5_pf ol og I spi This parameter specifies the name of a 
NOS/VE file* within the USERl catalog* which will fee 
attached to the current session environment (ATTACH 
operation)* This file will then be interpreted using the 
include capability* Omission will cause a file nawed 
SYSPROF tc be used* The functions performed by SYSPRGF 
can foe deterfnined by either doing a COPY SYSPROF or COPY 
NOTE command to see the contents at a terminal* 

family ? fJ This parameter specifies the nnme of the family to 
be accessed* Omission will cause a family name of NVi to 
be used* 

status! See ERROR HANDLING* 



E2.14*2 CITOII 

The purpose of this command is to get a CI object file or object 
library from NOS and to convert it to an II object file suitable 
for processing by the NOS/VE loader and/or object library 
gener ator* 

citoii ci«<NOS file name> 
Cil«<NOS/VE lfn>3 
Cuser«<NOS user name>3 
C status«<sta tus variable>3 

clJ This parameter specifies the NOS permanent file name of 
the CI object file or object library to be converted* 

lis This parameter specifies the NOS/VE file name on which the 
converted (i*e. II) object file is to be written. 

Omission will cause the CI file name to be used* 

users This parameter specifies the NOS user name In whose 
catalog the CI object file Is located* 

Omission will cause the user name of the user issuing the 
command to be used* 

status! See ERROR HANDLING* 
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E2,0 COWHAND INTERFACE STATUS 
E2.14*3 GBJLIST 



E2.14,3 CBJIIST 



The pyrpose of this coirniaod is to produce a forirsatted listing of 
a NOS/VE object module produced on NOS/VE U*e» II object text). 

objiist object«<lfn> 
CHst«<ifn>3 
Cstatus*<st stus V8riable>1 

object \ OS This parameter specifies the object file or object 
library to be listed* 

list I Is This parameter specifies the file on which the 
formatted listing Is to be written* 

Ofnission nI I I cause the listing to be printed on the 
loca I pr i nter • 

status? See ERROR HANDIING. 



E2a4«4 IINK.USER I LIU 

The LINK^USER coirmand is the same as documented in the NOS/VE 
command Interface with the exception that the alias LIU is 
supported in the current system and the CHARGE and PROJECT 
parameters ^re optional (and in fact not useful in the current 
environment since we disable that feature on the NOS side)* 



E2*14,5 GET 

This command is an Interim Implementation of the final GET_FIi€ 
command that is documented in the NOS/VE command interface* All 
users should use the GET^FILE procedure now available as the GET 
command will be withdrawn in subsequent builds* 

The GET command obtains a copy of a permanent file residing on 
the 170. The 170 permanent file can be either a direct or an 
indirect access permanent file. All parameters on the GET command 
are positional* Only the Mfn« parameter is required. A LINK_US£R 
command must be issued (for the 170 family on which the permanent 
file resides) prior to issuing the GET command* The form«t of the 
GET command Is J 
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GETi»lfn#pfn#pwfun*f«*cd» 

Ifn (local file nan^e) - This is the name of the local NOS/V€ 
file to Mhich the 170 permanent file *^lll toe transferred. 



pfn (permanent file na}i?e) - This Is the 
permanent file that Is to be accessed* 
omitted then »lfn' will be used for the 
name* 



name of the 170 

If this parameter is 

170 permanent file 



PH (password) - This is the password that will be used to 
access the 170 perirjanent file If a password is re^iulred to 
access the file on the 170» 



un (user name) - This is the user nafne 
Nhich the 170 permanent file resides* 



(alternate catalog) on 



fn5 (farplly) - This is the family on which the 170 permanent 
file resides* Currently the only 170 family on the S2 Dual 
State system is NVE* 

ca (conversion alternatives) - This paraiiseter specifies the 
type of conversion that is performed fey the IRHF on files 
transferred from 170 to 180* If this parameter is omitted 
then a default of 860 will be assumed* Values for this 
parameter are J 



860 s Basic Binary 



to the 
A bits 



of each 64 
to 180 using 



The full 60 bits of each 170 word are transferred 
lower 60 bits of each 64 bit 180 word* The upper 

bit 180 word are set to 0* The file is written 
BAM with Block Type * System and Record Type 
* Undefined (RT«U) so no control Information Is Inserted 
in the file* The 170 logical record structure is dropped 
(i*e*f EORs are deleted causing the logical records to be 
packed together* 

B56t CIBO Binary 

The lower 56 bits (7 8 bit bytes) of each 170 word are 
packed into contiguous 8 bit bytes on the 180 (i*e*f 7 8 
bit bytes from the first 170 word and 1 8 bit byte from 
the second 170 word go into the first 180 word etc*)* The 
170 logical record structure (EORs) are dropped* The way 
that the 180 file which was transferred from 170 is 
accessed should correspond to the method used to create it 
on the 180 originally (assuming that the file originated 
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on the 180). 

A6S 6/12 ASCII 

A170 6/12 ASCII character files <used toy KEOIT and Post 

SES utilities) are converted to 180 8/8 ASCII with Block 

Type « System) and Record Type = Variable <RT»W)* The 170 
logical record structure EQRs are dropped. 

A85 8/12 ASCII 

170 8/12 ASCII character files are converted to 180 8/8 
ASCII with Slock Type « Systen? and Record Type « Variable 
<RT«W). The 170 logical record structure <EQRs) are 
dropped. 

D64J Display Code 64 Character Set 

170 Display Code character files are converted to upper 
case 180 8/8 ASCII with Block Type * System and Record 
Type * Variable <RT«y). The 170 logical record structure 
EORs are dropped. 

Example of GET con^mands 

LIU*US*CFABfNVE),RA«FA8X>A«7136f PR«7 3E08802. 
GET* TEXT, T£XT612#»#NVE#A6. 

Note! yhen the GET command is used on the Simulator, the 
file specified by the 'pfn* paraineter must be a 170 
file which is local to the simulator job. 



E2.14.6 REPLACE 

This coiTjmand Is an interim implementation of the final 
REPLACE.FILE command that Is documented in the NOS/VE command 
interface. All users should use the REPLACE.FIIE procedure now 
available as the REPLACE command will be withdrawn in subsequent 
builds. 

The REPLACE command transfers a copy of a 180 local file to a 
permanent file on the 170. If a permanent file of the same name 
does not exist for the specified user <catalog)» a direct acccess 
permanent file is created. If a direct access permanent file of 
the same name already exists in the catalog and the file can be 
attached with write mode then the existing direct access file is 
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overwritten with the file froifi the 180» If an indirect access 
perf!?anent file of the same name already exists in the catalog then 
the indirect access file Is replaced by the file from the 18C« An 
existing indirect access file will oal fee changed to a direct 
access file if the user's Indirect access file size liaiit Is 
exceeded* REPLACE coffunand. All parameters All paraBieters or^ the 
REPLACE command are positional. Only the 'Ifn* parameter is 
required* A LINK_USER coirn^and siust be issued Cfor the 17C family 
on which the permanent file resides) prior to issuing the REPLACE 
cofTSfltand. The format of the REPLACE command iss 

REPLACEf I f n*pf n»pw#un#f m#ca« 

Ifn (local file name) - This is the name of the local NOS/VE 
file which will te transferred to a permanent file on the 
170. 

pfn (permanent file name) - This is the name of the 170 

permanent file that is to be created or replaced* If this 
parameter Is omitted then « I f n» will be used for the 170 
permanent file name* 

pw (password) - This is the password that will be associated 
with a newly created direct access file or which is used 
to gain access to an already existing direct or indirect 
access permanent file* 

un (user name) - This Is the user name (catalog) on which an 
existing 170 direct or indirect access file resides* This 
parameter is illegal If the file does not exist. 

fm (family) - This is the family on which the 170 permanent 
file is to reside* Currently the only 170 family on the 
SI Dual State system is NVE* 

ca (converlon alternatives) - This parameter specifies the 

type of conversion that is performed by the IRHF on files 
transferred from 180 to 170. If this parameter is omitted 
then a default of 860 will foe assumed* Values for this 
parameter are* 

8608 Basic Binary 

The lower 60 bits of each 64 bit 180 word are transferred 
to the full 60 bits of each 170 word* The upper 4 bits of 



each 64 bit 180 word are discarded* 
to be transferred should be written 
« System and Record Type « Undefind 



The 180 file which is 
by BAM with Block Type 
(RT«U). The file is 
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transferred to tiie 170 as a single logical record <!•€• 
files with multiple EQRs cannot be created on the 170 from 
the 180). 

B56t C180 Binary 

Groups of 7 contiguous 8 bit bytes from the 180 will be 
transferred to the lower 56 bits of each 170 word Cl»e« 
the first 7 8 bit bytes from the first 180 word go to the 
lower 56 bits of the first 170 word* the 8th 8 bit byte of 
the first 180 word and the first 6 8 bit bytes from the 
second 180 word go to the lower 56 bits of the second 170 
word etc.). The way that the 180 file to be transferred 
Is created does not matter because the entire structure of 
the 180 file is preserved on the 170. The file is 
transferred to the 170 as a single logical record. 



A6J 6/12 ASCII 

A 180 8/8 ASCII character file 
and Record Type * Variable CRT' 
6/12 ASCII file (used by XEDIT 
The file is transferred to the 
record* 



with Block Type « System 
W) is converted to a 170 
and most S€S utilities). 
170 as a single logical 



A8J 8/12 ASCII 

A 180 8/8 ASCII character file with Block Type « System 
and Record Type = Variable {RT«W) is converted to a 170 
8/12 ASCII file. The 170 file can be routed directly to 
the printer with the 170 ROUTE coifsmand with the €C»A9 
parameter. The file is transferred to the 170 as a single 
logical record. 

0645 Display Code 64 Character Set 

A 180 8/8 ASCII character file with Block Type « System 
and Record Type = Variable (RT«VI) is converted to a 170 
Display Code file with lower case characters mapped to 
upper case. ASCII special characters that do not have a 
Display Code equivalent sre converted to Display Code 
blanks. The file is transferred to the 170 as a single 
logical record. 



Example of REPLACE command* 



LIU>US«(FAB#NVE) fPA»FABX#A«7136f PR 
REPL ACE > MY FILE, FILE 856,, *NV£>B56. 



'73E08802. 
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E2*14,6 REPLACE 



Note: yhen the RiPtACE command is used on the Sifflulator# the 
file specified t3y the «pfn« paraipeter will become a 170 
file which is local to the simulator job. 
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E 3 • C £EQ£Ei^-.IMIIS£M£^iI^iyS 



The 'status* colyrsn indicates whether the procedure Is unchanged 
from the previous buildf modified froii the previous build or not 
available in this build* Footnotes are numbered within each 
sect I on. 



E 3 • 1 .£0i!!Mii2-£EQC£iiIM^ 



££ii£fiiJ4l££- 


lillM^ 


CIPSSCAM.PARAH^IIST 


unchanged 


CIPSTEST^PARAHETER 


unchanged 


CIPSGET.KEYWORO 


unchanged 


ClPS€£T.SET.COUNT 


unchanged 


CIPSGET.VALUE.COUNT 


unchanged 


CIP$T£ST_RAMGE 


unchanged 


CIPSGET.VALUE 


unchanged 


CLP$DECt ARE. VARIABLE 


unchanged 


CLPSREMQVE.VARIABLE 


unchanged 


ClP$REAO.VARIABLE 


unchanged 


CLP$yRIT€«VARIABt€ 


unchanged 


CLPSSCAN.COMMAND.FILE 


unchanged 


CLPSEND.SCAH.CaMHANO.FIlE 


unchanged 


ClPSSCAN.COHMANO.tlNE 


unchanged 


CLP$PUSH/POP COMMAND LIST 


unchanged 


CLPSCREATE.FILE.CONHECTION 


new 


CLPSDELETE^FILE.COHNECTIGN 


new 



E 3 . 2 .M£SSAS£.£ £li£EiIOE 



££i2£My££^ 

OSPSFORMAT.MESSAGE 
OSPSSET.STATUS. ABNORMAL 
OSP$APPEND_STATUS.PARAMETER 
DSP SAPPEHD.STATUS. INTEGER 



unchanged 
unchanged 
unchanged 
unchanged 
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E 3 . 3 ^EfiSflyiilf -fiAMA££li£!iI 



RHPSREQU€ST_HASS.STORA€£ unchanged 

RMPSREOUEST.TERHIHAL un changed 

All teriPinal attributes can be specified on the 
Rf^RSREQUEST. TERMINAL call byt only the following are 
operational s 

ay to. input 

transparent.mode 

pronipt_f i le 

o promptest ri ng 

Files assigned to a terminal device can be accessed via the 
following BAH requests J 

AHPSOPEN 

AHPSGET.NEXT 

AHPSGET.DIRECT 

AHP$GET_PARTIAL 

Af^PSPUT.NEXT 

AMPSPUT^DIRECT 

AMPSPUT.PARTIAL 

Af^PSCLOSE 



E 3 . 4 ^£R Q£gAM-OICy IIQti 



££i2££ilM£S> ItaiU^ 

PflPSEXIT unchanged 

PHPSEXECUTE unchanged - ♦! 

PHPSTERMINATE unchanged 

PHPSAyAIT.TASK.TERMIHATION unchanged 

P r^P$HODUL€_TABL EVADOR ESS unchanged 

PHP$£NTRY.POINT_TABLE.AO0R£SS unchanged 

PHP$PUSH_JOB.DEBUG_MODE unchanged 

PMP$POP.JOB«0E8UG.Ma0E unchanged 

PHP$S£T.J0B.DE8U6.H00E unchanged 

PMP$ J06.de BUG.MODE^ON unchanged 

PHP$PUSH.TASK.DEBUG.nODE unchanged 

PMP$SET.TASK.0£BU6.H00E unchanged 

PHPSTASK.DEBUG.MQDE.ON unchanged 
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E3.4 PROSRAH EXECUTION 



PHPSSET.DEBUG.RING 
PMPSDEBUG.RfNG 

PMR$CHANG£_DEBUG.LI8RARY.IIST 
RMP$R0P.TASK.0E8UG_^0D€ 



unchanged 
unchangecl 
unchanged 
unchanged 



*1 DO NOT specify the values 'lOUTPUT' or «OUTPUT« for the field 
LCA0_?1AP_EILE of the program description - doing so will crash 
the systei!5« 



E 3 . 5 .£EQ££All-£QtiaUMKAIIQM 



ttasi&^utM^ 


Siaiiii 


OSPSAyAIT.ACTIVITY^CQHPlETION 


unchanged 


PflPSCEFINE. QUEUE 


unchanged 


PHPSREHOVE^OUEUE 


unchanged 


PHPSCONNECT^QUEUE 


unchanged 


PHPSDISCONNECT.QUEUE 


unchanged 


PHPSSEND^TO.QUEUE 


unchanged 


PHPSRECEIVE.FRQM^QUEUE 


unchanged 


PHPSSTATUS.QUEUE 


unchanged 


PHP$ STATUS. Queues. DEFINED 


unchanged 


PHPSGET.QUEUE.LIMITS 


unchanged 



E3 .6 .£QMI2illOI^.££QC£illtl£ 



££a££jdii££^ itjiy^ 

PHP$ESTABLISH.CONDITION.HANOLER unchanged 

PHP SDISESTABl IS H.COND.HANOIER unchanged 

P HPSCAUS E.CONDI T I ON unchanged 

PMPSCGNTINUE.TO.CAUSE unchanged 

PHP$TEST_COHDITION.HANOL£R unchanged 

PHPSVAIIDATE.PREVIOUS.SAVE.AREA unchanged 

PHP$ESTABLISH.0E8UG.CFF unchanged 

OSPSSET.STATUS.FROM.CONDITIQH new 



E3,7 .£EO££All-:S£EYiC£i 



PMPSGET.TIHE 



unchanged 
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PHP$€ET.HICR0SEC0ND.C10CK 

PHPSGET.TASK.CP.TIME 

PHPSGET.OATE 

PMPSGET^USER.IDENTIFICATaN 

PHP$6ET_ACC0UNT. PROJECT 

PNP$6€T.JQB_NAHES 

PMPSGET.JOB.ID 

PHPIGET.JQB.MODE 

PHPSGET.PROGRAM 

PHPIGET.TASK.ID 

PHPSWANAGE^SENSE. SWITCHES 

PHP$GET.QS_ VERS ION 

PHP$GET.PRGCESSQR_ATTRI8UTES 

PMPSDEFINE^OEByG.ENTRY 

PHPtGET^OEBUG^ENTRY 

PHP$ liODIFY_D€8UG_eNTRY 

PMPSREHOVE.DEBOG^ENTRY 



unch 
unch 
unch 
ynch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
an oed 
anged 
anged 
anged 
anged 
anged 
an ged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



E3.8 .iflSSlMS 



PHPSLOG 
PHPSLOG.ASCII 



unchanged 
unchanged 



£ 3 • 9 «£IiI.MHj&£II2£MI 



Sequential Access 
Byte^Addressabl e Access 
Record Access 
Segment Access 
W.System Specified 
W _U s e r Specified 
U^System Specified 
ILUser Specified 
F^Systeii Specified 
F_User Specified 

AMP$DESCRIBE_N€W_FIL€ 
AMPSFIIE 

AMPSGET.FILE.AT TRIBUTES 
A MP $f ETCH 



♦ 1 

unchanged 

*1 

unchanged 

unchanged 

new 

unchanged 

new 

unchanged 

new 

unchanged 
unchanged 
unchanged 
unchanged 
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AHPSSTORE unchanged 

AHP$COPY_FILE new 

AHP$f?ENAME new 

AflPSPETyRN.lOCAl.EILE new 

AMPSCPEN unchanged added paranieter 

AMPSCLOSE unchanged 

AHPSFETCH.ACCESS.INEOPHATION unchanged 

AHPISKIP *4 

AMP$PEyiNO *2 

Af«P$yRIT£_ENO_PARTITIOH new 

AHPSGET.NEXT ♦! f *5 

AMPSGET.OIRECT unchanged 

AHPSGET.PARTIAL *1# *6 

AHP$GeT„PARTIAL.DIRECT unchanged 

AHPSPUT.NEKT ♦! 

AHPSPUT.OIRECT unchanged 

AHPSPUT.PARTIAl *lf *3 

AMPSPUT^PARTIAL^OIRECT unchanged 

AHPSSEEK.OIRECT unchanged 

AHPSGET^SEGMENT. POINTER unchanged 

AHP$SET.SEGHENT.EOI unchanged 

AMPfSET.SEGHENT.POSITION unchanged 

AHPSSET.lQCAl.NAHE^ABMORMAl new 

AHPISET.FILE^IN STANCE. ABNORMAL new 

AHPSACCeSS.METHOO new 

AHP$EETCH_.FAP. POINTER new 

AMP$STOR£«FAP_POINTER unchanged 

*I user specified felocking is now supported 

*Z AHPSREWINO 

The WAIT parameter on the procedure cail is not supported* 

*3 AHPSPUT.PARTIAL 

PUT.PARTIAl with the TERM.OPTION « AHCSSTART does Qfli start a 
new record* 

*4 AMP$SKIP 

If the number of units to skip « and the file is positioned 
fflid-unit the file will remain positioned f!?id-unlt» 

*5 AMPSGET.NEXT 

A GET_NEXT with a work i ng.storage length « will return an 
undefined file position. A request of zero length is invalid 
and will result in abnormal termination in later builds* 

^b AHPSGET.PARTIAL 

A GET. PARTIAL of record type « undefined never returns file 
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pcsltlor) of end-of-record. 



£3,10 «££IBMIMI.£iL£«l2ili^££B£i^I 



l>FP$DEFINE 

PFPIATTACH 

PfPtPmSB 

PFP$CHANG€ 

PFPSPERfllT 

PFPSOELETE^PERMIT 

PFPSOEf INE.CATALOG 

PFPSPUPGE.CATALOG 

PFPSPERMIT.CATALOG 

PFP$DELETE.CATALOG.P€RHIT 



parameter changes 

parameter changes 

parameter changes 

parameter changes 

parameter changes 

parameter changes 

parameter changes 

parameter changes 

parameter changes 

parameter changes 



ylld N PerJPanent File Program Interface Deficiencies 

• In order to access the NOS/VE permanent files of a usert a 
master catalog must exist for that user. At release one timet 
the validation facility will create a master catalog for a user 
when the user is created* At build N* however* the validation 
facility does not exist* To circumvent this problem* the LOGIN 
command has been modified to create a master catalog for the 
user being logged in* Thus* once a user has logged in it will 
be possible to perform NOS/VE permanent file operations for 
that user* Since a LOGIN command will eventually be required 
for all jobs* it should be no hardship to include It In jobs 
starting with build N* 



2* Permanent files on the NOS/VE 
NOS/VE deadstart. 

3. The iJAIT parameter for ATTACH 
PFCSNQ.WAIT is specified. 



are only permanent until a 



is always treated as if 



E3.11 .MSaQEX^MMSiaMI 



MMP$ADVrSE_IN 

MHP$ADVISE_OUT 

HMPSADVISE.aUT.IN 

WMP SPRITE, MODIFIED. PAGES 

MnP$CREATE.SEG?1ENT 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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E3.11 nEnmy management 



HHPSDELETE. SEGMENT 

HHP$ST0f?E_$EGH6NT.ATTRI8UTES 

MHPSEETCH.SEGHENT.ATTRIBUTES 

HHf>$ViRIFY.ACCESS 

HHPSFRiE 

HHPSIOCK.PAGES 

HHPSUNtOCK.PAGES 

HHPSFETCH.PVA.UNyRITTEN.PAGES 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



£3.12 .llillHia-EiCILlIX 



SFPSESTASLISH.STATISTIC 

SFP$€NA8LE. STATISTIC 

SFP$DISA8iE.STATISTIC 

SFPIOISESTABLISH^STATISTIC 

SFPSEMIT.STATISTIC 

SFPSE MIT. SYS TEH. ST AT I STIC 



new 
new 
new 
new 
new 
new 



€3.13 MQ5iI£.£K££IiQMl 



The following summarizes the exception code ranges currently 
assigned to HOS/VE. These code ranges represent a finer breakdown 
than the one specified in the SIS for Internal NOS/VE development 
purposes. However* It Is important to refneraber that only the 
product identifiers documented in the SIS may appear in error 
messages . 



Cojiipcn Modules 
Common Code Generator 



Exception Code 

1 - 158*999 
159fC00 - 159>999 
laOfOCO " 169*999 

160*000 - 163*999 
164*000 - 164*999 
165*000 -• 165*999 
166*000 - 166*999 
167*000 - 167999 
170*000 - 179*999 
18C*0G0 - 189*999 
190*000 • 199*999 



9*000 - 9*999 
8*000 - 8*999 



Product 
Identi f ier 

Reserved 

SY 

AM 

BA 

IN 

JF 

CM 
CL 
JM 



Product Name 



System Core 

Basic Access Methods 

Basic Access 

Local Name Mgr 

Job File Mgr 

Conversion Services 

Configuration Mgmt 

Command Language 

Job Management 

Loader 
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E3 


.0 PRCGRAW : 


[NTERFACe STATUS 




E3 


.13^N0S/VE^1 


EXCEPTIONS 








200*000 




209,999 


HH 


Hemory Hanagesient 




200*000 


- 


204,999 


m. 


Honitor level 




20 5*000 


- 205,999 


HH 


Task Level 




210*000 


~ 


219,999 


OS 


Operating Systew 




210*( 


DOC 


- 210,999 


OS 


OS 




Zllfi 


DOC 


- 211,999 


HT 


EXEC 




212* i 


COC 


> - 212,999 


10 


m I/O 




213 fi 


DOC 


> - 213,999 


10 


Tape I/O 




214*^ 


DOC 


- 214,999 


DM 


Device HanageR?ef^t 




215*1 


Doa 


~ 215,999 


HL 


Heiuory i ink 




216* ( 


DOC 


~ 216,999 


IF 


Inter act ive 




217*< 


DOC 


- 217,999 


TH 


TH Monitor 




218*< 


DOG 


- 218,999 


TH 


TH Task 




219*1 


DOC 


- 219,999 


JS 


Job Swappers 




220*000 


- 


229,999 


PF 


PerfJianent File Management 




2 21, < 


DOC 


1 - 221,999 


ST 


Set Management 




222*< 


DOC 


) - 222,999 


PU 


Permanent File Utilities 




230*000 


- 


239*999 


P.H 


Program Management 




240*000 


~ 


249,999 


RM 


Resource Management 




250*000 


- 


259*999 


OF 


Oper ator Faci 1 i ty 




260*000 


- 


269,999 


AV 


User Administrator 




270,000 


- 


279*999 


IC 


Interstate Communication 




280*000 


- 


289,999 


RH 


Remote Host Faci 1 i ty 




290*000 


- 


299,999 


DC 


Object Code Ut i 1 Ities 




300,000 


- 


309,999 


OB 


Deadstart /Recovery 




310*000 


- 


319*999 


m 


Maintenance Services 




320,000 


~ 


329*999 


Reserved 






340,000 


- 


349*999 


SF 


Statistics Fac« 




330,000 


- 


339*999 


US 


User Errors 




500,000 


- 


509*999 


AA 


Advanced Access Method 




510,000 


- 


519*999 


AG 


ALGOL 




520,000 


- 


529*999 


At 


Assembly Language 




530,000 


- 


539*999 


AP 


API 




540,000 


- 


549*999 


8A 


BASIC 




550,000 


- 


559*999 


CA 


Conversion Aids System 




560,000 


- 


569*999 


CB 


COBOL 




570,000 


- 


579*999 


CY 


CY8IL 




580*000 


- 


589*999 


FT 


FORTRAN 




590,000 


- 


599*999 


PA 


PASCAL (Mirth) 




600,000 


- 


609,999 


PI 


PL/1 




610,000 


- 


619,999 


sn 


Sort Merge 




620,000 


- 


629,999 


sc 


Source Code Ut i 1 i ty 




640,000 


- 


649,999 


OB 


Debug 
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E 4 * fiy AL-iIiI£-MlMIi£I^lMO.Q££EAIiI]M 



£4.1 ii2a.MJQ5.l2£^0SIA£I 

The system is configured to run with three FMO units (41f 42 and 
43)* 

Set the D/S panel to deadstart fro^ the primary system disk* 
This is Unit 43 for all Build N systems* 

Push D/S button 

o Select **G** di spl ay 

Select •*H*' display 

Enter CH«10C00 

Enter (CR) 

Enter date/time 

Wait for deadstart to coinplete* 

Note? The deadstart tape DUAL6N (which is currently Installed on 
unit 43) is found in the area In the northeast corner of the room 
where the tape cabinet Is found* 



£4*2 £y£££MI-i2yAL.lIAI£.CCM£I£yaiIIfl!i 

FMD Unit 43 

This unit contains the foil owing i 

- A170 HOS (Build 6 leveDj CTI* CHSE» £1 binaries* NOS 
deadstart f i I es 

~ Files associated with user number LIBRARY 
Files associated with user number SES 

- Files associated with DEVI* DEV2f R£L1# INTl* 

FMD Unit 41 

This is a scratch unit 
FMD Unit 42 
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E4.G DUAL STATE OEADSTART AND OPERATION 
E4.2 CURRENT DUAL STATE CONFIGURATION 



This unit contains the following! 

NOS/VE Oevelopffient Area PL's and Hepber Pt«s 

- NOS/VE Deadstart Files to be tested (saved in Individual 
user's catalogs) 

- Files associated with user number INT2 



E ^ . 3 ay^U^IiI£JL-^iQS.Q££ElIIQii 

1) The convention used for creating user numbers on NOS/VE is as 
f ol I ows J 

o Your user nurr^ber will be your initials. 

Your password will be these 3 letters followed by the letter 
* X » . 

Yoy nsust see COHSOURCE CR.K* Cooper ~ x3092) to be assigned 
a user Index 

2) PF dumping and loading 

You may use "SES.DUMPPF*' on SN/101 to dump your permanent fles 
to tape^ &n<3 then load thei!! onto your user number on A170 NOS 
using •»SES«LOADPF"» Documentation on how to use these SES 
procedure and what their parameters are is included in the SES 
"User's Guide* or they c^o be obtained by typlngi 

**SES,HELP.OUHPPF" and "SES# HELP.LOADPF", 

E4.4 !iOSiM£.l2finiI4£I 

The following file roust be available in your catalog on the S23 

TPXXXK contains a NOS/VE deadstart image. This must be a copy 
of the dual state deadstart images available from the llnK 
procedures. 

CHIMAGE, PPIHAGEj RGIflAGE are "fast" files* which are built from 
TPXXXK the first time you deadstart NOS/VE. These files are 
then used on subsequent deadstart attempts. Before a new TPXXXK 
can be used* these "fast" files must be purged off your user 

number. 

For Build Hi Hount the disk labeled "OAHl-Large sector" on 844 
unit (other disks will not work). The HCS disk driver (for 
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small sector 844 's) will not work in Build N» 

For Builds greater than 05s Hount one of the disks labeled **SZ 
S/H 104 system scratch" on 844 unit 1# This cannot be a large 
sector diski For Builds n > 23 and > 5 the remote 
host/ inter act ive 170 binaries must be sysedited into the running 
systerr until the deadstart tape has been updateds 

X.DIS. 

USERfSCATjSCATX, 

where "scat" = 0€V1 for Build N 

"scat" » INTl for bui Id 

CALLjSYEDNVE, 

DROP, 

Bring up dual states 

X.UPMYVE CCAT-mycatj OEVl«scat) 

where fnycat « user catalog (as before) 

scat s system ctalog - IHT2^ INTl or 0eV2 

o The UPHYVE job will display the followingJ 

RFQU6ST *K* DISPLAY on the B display 

Type K»n» where n is the control point number of the UPMYVE 
job. 

NOS/VF Is currently generated and initialized on both NOS and 
NOS/VF. All source and object libraries that make up the NOS/VE 
system are produced on NOS and therefore must be converted from 
their CI to II counterparts. Other parts of installing and 
initializing the system Ce.g. building the SSYSTEM catalogue) are 
performed by command language procedures on HOS/VE. Since the same 
system will be deadstar inany times in a closed shop environment* it 
Is advantageous to only perform the conversion from CI to II a 
single timej save the results in the NOS file system and then 
simply bring the files back during deadstart. 

The actual files that get Installed and loaded on each deadstart 
are determined by a command language procedure <the system profile) 
interpreted on NOS/VE* This procedure can be modified by each site 
to initialize their NOS/VE environment in the most suitable 
fashion. The process of building the system profile an of 
performing the CI to II conversions is referred to as an 
installation deadstart and the process of executing the system 
profile and of fetching previously converted files from NOS and 
making them available in the NOS/VE file system is referred to as a 
deadstart. A single command Is available to perform both an 
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E4.4 NQS/Ve DEADSTART 



installatjon deadstart and a deadstart 



€4.4.1 OS 



The ptjrpose of tliis comm&n6 is to perform an Installation 
deadstart or a deadstart of NQS/VE. 

ds t i nstal I «<fooolean>1 

C I oad.source^ li far ar i es«<booi ean> J 
CI 03d_products*<bool ean>3 
Cs tatus«<status variabl€>] 

Install J M This parameter specifies whether an instaliatlon 
deadstart Is to foe performed* Valid specifications areJ 
TRUE - Installation deadstart to be performed 
FALSE - deadstart to be performed 

Omission will cause a deadstart to be performed. 

load^sour ce_l i br ar i es J IsM This parameter specifies whether 
SCU libraries are to be loaded. Valid specifications 
are! 

TRUE - libraries are loaded 
FALSE - libraries are not loaded 

On the Arden Hills closed shop S2 system^ the SCU 

libraries to be loaded ares 

QSLPI ~ operating system program interface 

Subset of NGSVEPL - operating system source library 

Omission will cause SCU libraries to be loaded* 

load^products * Ips This parameter specifies whether the 

object libraries defining the current product set are to 
be loaded. Valid specifications ares 
TRUE - the products are loaded 
FALSE ~ the products are not loaded 

On the Arden Hills closed shop S2 system* the product set 
to be loaded consists ofs 

CY8IL 

SCU 

Omission i«ill cause the product set to be loaded, 
status: See ERROR HANDLING in the NOS/VE ERS. 
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If yoy change any of the following decks you HUST use the 
Installation deadstart from your own catalog Iwith files CYSIlSOj 
KIJQSL# and XLJLIB) i 



AHHTSA 

IFHEXEC 

OCHSDt 

OCHOLG 

OCHCOH 

RHHQTE 



BAHDVR 

IIHA72H 

OCMENO 

OCHCOi 

OCHSAT 

RHHLCF 

RHMRTH 



8AMPC4 

n?^TDEl 

OCHLP 

QCMOBJ 
RHHQAF 



8AHPC2 
IIHRUSH 
OCHCPY 
OCHCHA 

RHMIGS 

RHMGDH 



8AHPC1 

IIHDC2S 

QCHCRM 

OCHQFH 

RHHQIP 

USQRT 



8AMPC3 
OCHREO 
OCMGEN 
QCMADO 
RHHSFM 
RHHQRE 
UUSERl 



IIHRSE 

OCHHUR 

OCMHCMS 

OC«NP 

RHMLOF 

RHHA12 

UUTL 



IIMRIE 
0CM8IH 
OCMDEF 
OCHOEi 
RHMMII 
RHH12A 



IIMRUM 

OCMREP 
OCHDLS 
RHHQOP 
RHMROU 



E4.4,2 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 



Type 

Kfn. where n is the UPHYVE control point number. 

K.LIU (your un^NVE) your.passwor d« 

K.GET#DS»DS>fSCAT#NV£,A6. 

K.DS TRUE FALSE FALSE. 

The systei!? is up when the following fnessage cotrjes upJ 

SYSTEM IS NOW ALL UP AND RUNNING 
WAITING FOR MORE INPUT 



E4.4.3 EXAHPLE OF HOS/VE DEADSTART 



The Integration system has had the installation deadstart run on 
It. Also the files produced by the installation deadstart have 
been niade semi-private and are found on the catalog used in the 
UPMYVE call. 

Type (where DEVI Is the same as the CAT«value In the UPMYVE 

c a I I ) s 

K>n. where n is the UPMYVE control point number. 

K.LIU (DEV1>NVE) DEVIX. 

K.GET,DS#DS###NV£f A6. 

K.DS. 

The system is up when the following message comes ups 
SYSTEM IS NOy ALL UP AND RUNNING 
WAITING FOR MORE INPUT 
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E4,0 DUAL STATE DEADSTART AND OPERATION 
E4,5 HOS/VE TERHINATIQN 



E4.5 MOiiV£-I££BIMAIICi 

Bringing down dual states 

K,*8YEVE« 
If not a nor?Bal termination 

K.*£NDIST, 
K«*ENDRUN, 

E4,6 Mni-IM£flfiMAIIOM 

To create an Express Deadstart Dump CEOO) tapes 

1) Hount scratch tape (ring in) on a 9-track drive* 

2) Push D/S button, 

3) Select U {utilities) display* 

4) Select E (EDO) display. 

5) Set channel (S2«13), 

6) Set ECyy (S2«01uu) 

E « equipfnent 

C « 1 for 67X drives 
2 for 66X drives 

uu « unit number of the tape drive to be used* 

7) Answer "non zero inhibits rewind** with a CR» 

8) Answer **duinp number** with a CR» 

9) Answer "dump control ware** with a CR. 

♦ - Warning if this step is omitted* OSDI canot process 
the dump tape. 

To create a listing of the EDO tapes 
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€4.0 OUAl STATE OIADSTART AND OPERATION 
E4«6 DSDI INFORMATION 



II REQUEST*DyHP»NT*0=PE,F«S»lB=KyfPO*RfVSN«your choice. 

2) GET^0S0I/UN*06V1. (On S/N lOl,) 

or 
G£T»0S0I/UN«0EV1« (On S2.) 

3) Create DSDI directives fiies 

A DSOI directive file should include the following^ 

lOOHR. 

PROMR. 

HEMHR. 

PRORF, 

y#first_byte_ ad dress*! ast.byt e_adress# as I d» (where the 

f lrst_by te_8ddress and I ast.byte^address are hex byte 

addresses and asid is the asid of the segment to be 

dumped) 

4) Execute OSOU 

RFL>60C00. 

DSDIf M#0*I«»»input directives file**, 

5) To run (after the first time)? 
OSDIf I»n. 

(Does not read tape again.) 

6) To run i nteract i vel y s 

Same as above* except to do W command must first do? 
OUTPUTfLISTFIL. 

7) C170 DSDI information can be found in Chapter 10 of the 
NOS SYSTEM MAINTENANCE Manual. 

A170 OSOI info can be found in document ARH3060 — GIO 
for A170 N0S/S2. 
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E4.0 DUAL STATE OEADSTART AND OPERATION 
E4,? A17G NOS SHUTOOli^N 



£4*7 ill^^MQi.iMiJli^IliilN 



Before leaving the mBcf-inep it is necessary to bring NOS 
down. If NOS f^as crashed* a ievel 3 deadstart m«st be attempted 
even If the only reason is to bring NOS down. To bring NOS down» 
do the f ol I ohI ngs 

1) Enters 

CHE 

The screen will displays 
CHECKPOINT SYSTEH. 
Enters carriage retyrn 

2> Hake sure no mass storage device has a checkpoint rguested* 
To do this* enters E#H» If the display shows there are no 
»*C"s in the status field* then all devices are checkpointed 

and you mny continue* 

3) Enters 
STEP. 

4) Push deadstart button. 



E 4 . 8 lillJEBIB^lJltlUfil.LIlilE- SII]£Ai£.aQl£-CQtiSIO£aAIIOIii 



The following precautions must be taken when running dual 
state with the Interim Meirory Link. 

1) Drop IRHF17G* PASSQN and all permanent file partner jobs 
before doing *BYEVE (via 2. STOP.) 

2) Do not rollout IRHF17C# PASSON or permanent file partner jobs 
at any tin^e. 

3) Before doing a CHECKPOINT SYSTEM* drop IRHF170* PASSON and 
all permanent file partner jobs (via 2.ST0P.) 

4) If the systen? crashes a N0S/A170 level 3 deadstart is the 
preferred action. If for sowe reason you must do an HCU 
recovery (REC conimand) do the followings 

- Clear word 17(8) vias 
99, 
17*0. 
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E4.0 DUAL STATE DEADSTART AND OPERATION 

£4.8 INTERIH MEI10RY LINK STORAGE HOVE CONSIDERATIONS 



Enter REC on the HCU console* 

Finish up in A17C only luode (i«e,» do not do an UPHYVE)> 
then do a level 3 deadstart* If yoy bring up NOS/VE again 
without doing a level 3 deadstartt the results are 
unpred i ctabi e. 

€ 4 • 9 l^flSiMi-lBIf EA£IlIf .fi£ILIIX.Q££SiIIQM 

£4.9*1 OPERATOR INITIATION 

To bring up the NOS/VE Interactive facility do the folfowingJ 

1) Bring up NOS/VE* S 

2) Bring up HAM 

At the systeffi console enter? 

3, NAM* t 

3) If lAF is not up at control point 1» enters 5 
lAE. 

4) Bring up A170 part of interactive? * 

- TAFNVE* ; 

Control point two must be free or roMoutable (i*e* NAM should « 
not be there). This also brings up PASSON and the MLI subsystem » 
control points. J 

E4,9.2 OPERATOR TERf^INATION 

To terminate NOS/VE interactive any of the following may be 
d o n € t 

- 3.CF0.DIf AP«TAF. (3 is the NAM control point number) 

This is the preferred method. To bring NOS/VE interactive 
back uPf you must first do a 3*CF0*£N> AP«TAF. 

3.CFG.DI*NE* (3 is the NAM control point number) S 
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E4,0 DUAL STATE D^ADSTART AND OPERATION 
€4.9.2 OPERATOR TERHIHATIOH 



This teri^inates the entire net^iork including lAFfRBF* etc 



€4.9.3 OTHER OPERATOR CAPABILITIES 



To send a "shutdown earning" to all terminals logged on to TAF 

do t 

3.CF0.ID*AP»TAF. C2 Is the NAM control point numberJ 

- To sen6 a lies sage to all terminals do 5 

3*CF0*HSG# ALLfmesage. (2 Is the NAH control point number) 

~ PASSON has the ability to record various types of diagnostic 
information. This capability is controlled via the sense 
switches at the PASSOH control point. To turn a sense switch 
on <off) at control point N doJ 

N.ONSWX. (N.OFFSWX.) 

yhere X is the desired sense switch <1 to 6). The PASSON 
default is all sense switches off. It will take a short 
period of time before PASSON detects a change In a sense 
switch end reacts to it. The sense switches currently used by 
PASSON areJ 



1 
2 

3 



Network Trace 

PASSON logic Trace To Dayflle 

Memory Link Trace To Dayflle 



E4.10 IQ.££iQiIi.£l3!^iafliMA££.£QS-Iti£-aAML=LASS£«i££I0£.Sii 



The following coniffiands need to be entered from deadstart 

Push D/S button 

Se I ect **U*' dl spl ay 

Select "S" displ ay 

Select TYPE«3 

Select CM«1 

Select CH»1 
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E4«0 OUAl STATE OEAOSTART AND OPERATION 

E4.10 TO l?ELOAO CONTROIWARE fOR THE OAHL-LARGE SECTOR 844 



o Select €Q«0 

Select UN=th€ unit number of the system pack (43) 

Select "H" displ ay 

Carr I age return 

Type in "CM HAS 22" carriage return wait until LOADED 

Then redeadstart using section 1 



€4,10«1 ROUTE AN INPUT FILE FROH C170 TO C180 

Through the system console* enters 

Type 

X.DIS« 

USERf A#S* 

GETf f i lenaflne. 

where filename identifies the input file to be routed. 

ROUTEff i lename*DC=LP,FC*RH. 

E4,ll li.DlJS£UI-.MCii 



Support of 6-12 ASCII from the console {K display) causes the 
following changes! 



/I 


A 


/( 






I 




/2 


II 


/) 






3 




/3 


# 


/ + 






> 




/4 


$ 


/- 






< 




/5 


(reversed / ) 


/« 






• 




/6 


• 


/* 






i 


(single quote) 


11 


1 


// 






/ 




/8 


c 


/* 






t 




/9 


> 


/A 


to 


It 


a 


- z ( lower case) 


/O 


_ (underscore) 













(The major incompatibilities with earlier systems are for 
characters for | and •• To get a semicolon* type /6# to get 
a * (single quote)# type /* 
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E5.C AROEN HILIS OEVEIOPHENT LAB SUPPORT BY IHT€GRATIQH 



£5,0 M12£M-!JliU-a£MLQ£B£MI-L^i.Sy ££fl£I.ll-iMIi£IMll}M 



yhat we have estafollstied in the lab so far is the followingi « 

A 600 tape capacity tape rack for general use* If you project * 
would like to resery^ % section of this tape rack* contact Tiro • 
HcGlbbon or Bonn le Swi erzbl n* % 

~ A tape and disk cabinet for storage of system support 

materials which this project will inanage and keep up to date* 
(If you have been using this cabinet for unauthorized storage 
- beware. We have the key to the lock!) More will be 




- A two-level documentation rack for system documentation 
listings. This contains the current build conipilation listing 
and listing of the NOS/VE PPU routines* system link map* This 
rack is along the west wall at this time* 

A desk documentation rack for reference manuals and Tom 
Hc€e€«s collection of "how to»» goodies* The objective is to 
have this reference Information at arm's length of the 
console* but it is currently on top of the two-level unit by 
the West wall* 

- At or near the console is a SJnall notebook containing the NOS 
System Programmer's Instant* NOS Application Programmer's 
Instant* and the 180 Instruction codes* 

Feel free to examine and use all of the above materials while In 
the lab. |}fi-Bfii«££ia^£-.fl£-JiiUSS.flni:«fil.illJBSfi-lifilfi£lalSji- Please 
notify Tim McGibbon or Bonnie Swierzbin of any problems or 
deficiencies of these materials* Leave a note If we are not 
aval I abl e* 
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£§•0 ARDIN HILLS DEVELGPHENT LA8 SUPPORT 8Y INTEGRATION 



i££fMMl-i^MQS/Mf-IMIlliiOilMS.!ll2(iyi!£iII 



l.G Hardware Overview 

1.1 An Ir^troduction to CYBER 180 

1.2 C18C Instant 

1.3 Model Independent Generai Design Specification ~ ARH1700 

2.0 NOS Reference flanyals 

2.1 X€OIT V3.0 - 60455730 

2.2 lAF VI. User's Guide - 60455260 

2.3 NOS Reference Hanual - Vol 1» 60435400 - Vol 2$ 60445300 

2.4 NOS Instant 

2.5 NOS Operators Guide - 60435600 

2.6 NOS Diagnostic Handbook 

2.7 NOS A170 ERS 

2.8 NOS A170 GID - ARH3060 



3.0 NOS/VE Reference Documents 

3.1 PrograiTi Interface ERS - ARH3610 - obtained from Karen 
Rubey (482-3966) or via SES.TOQLDOC 

3.2 Command Interface ERS - ARH3609 - obtained from Karen 
Rubey C482-3966) or via SES.TOQLDOC 

3.3 NQS/VE Procedures and Conventions - SESDOIO - obtained by 
SES.TOOLDOC 

3.4 Listing of all NOS/VE Modules ~ obtained by 

SESf DEVl.LISTNVE. See Integration Procedures Notebook 
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€5*0 ARDEN HIILS OEVEIOPMENT LA8 SUPPORT BY INTEGRATION 

for details. 
3«5 NOS/VE Internal Interface Halntenance Procedures 

Hefflo available froii; S»C. Wood* 
3*6 Integration Procedures Notebook 

Obtained by J 

Acquire, I PNOQC/UN«D€ VI. SSS* PRINT, IPNDOC* 

4,0 Tools Reference Oocuwents 

4.1 CYBIL Interactive Debugger - ARH3142 

4.2 SES User's Guide - ARH1833 

4.3 CYBIL Specification - ARH2298 

4.4 C180 Assembler ERS - ARH1693 

4.5 SifTiulator ERS - ARH1729 

4.6 VEGEN ERS - ARH2591 

4.7 VELINK ERS - ARH2816 

4.8 Simulated I/O ERS - ARH3125 

4.9 Object Code Utilities ERS ~ ARH2922 

4.10 CYBIL Iffipl enfentat ion Dependent Handbook - ARH3078 
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fl*Q INTRQOiJCTrOH 



Fi,o iiiiBmyciifiti 



Fi^l £yE£flS£ 



The purpose of this document is to give an overview of the 
NOS/VE system Cformerly called HCS) from the fol lowing 
perspec t i vesJ 

- Adding user tasks (tests) 

" Hodifying NOS/V€ components 

- Adding new NOS/VE corrsponents 

- System usage ~ hardware and simulator 

- Hints 
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l=2,0 ADDING USER TASKS TO NQS/VE 



F 2 . C Maili£-Ui£E-IiS!ll-I2«MQSZII 



F2.G.1 IHTRGOUCTION 

A user tasl< can be defined as a group of modules Hriked 
togetiier that wi I J execute In tlie 'user rtng* of NOS/VE> 
currently ring 11« This task may make calls to any gated entries 
vrlthin task services (rings 1 through 3) If the call bracket will 
allow the call* Data defined within task services may not be 
referenced froir? rings 4-15* 

P2.0«2 USING THE V€ LINKER 

The general format of the LINK command isJ 

SES.VELINK LFL'^CYSILia LPF«LIBLC8 OFL^LGO NS«LIBX 

The LPF parameter specifies the file containing Virtual 
Environment Linker variables that control the linkage. If the 
LPF parameter Is not specified^ these variables default to values 
provided by the VELINK procedure. The values for both the LFL 
and OFL parameters may be anything the user requires - it is 
these parameter that define the makeup of a given user task. The 
V£ Linker ERS should be consulted for a detailed description of 
the available parameters. 

Every LINK command creates one unique user task. The value 
for the NS parameter must be unique among all user tasks In a 
given virtual environment build. The value given must be 4 
characters and cannot be either HTRX or STSX# as these values are 
used for monitor and task services. 

The following example should help to clarify how to make the 
modifications. Suppose we want to create two user tasks. The 
first requires object files A and 8 from the current users 
catalog and file CC from catalog INT2. The second task requires 
object files and E from the current catalog and library file 
LI. The necessary commands are< 

ACQUIRFfCC/UN=INT2 
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F2,0 ADDING USER TASKS TO NOS/VE 
F2.0.2 USING THE VE LINKER 



SES*VELINK 
SES.VELINK 
NS«II8Z 



IFL'CYBILIB LPF=lI8LCe aFl«<A,B,CC) NS'LIBX 
tFL=CLl*CYBIlIB) LPF=II8LC8 OFl«IO,E) .. 



There are five things to note about this exaroplei 



of multiple values with the LFL and OFL parameters (up 

I inker 



1) The use 
to 10). 

2) The fact that local files are referenced first by the 
before they are searched for In the user's catalog* 

3) The use of a continuation (•») card* 

4) The unique NS values LIBX and LIBZ. 

3) The assumption that CY811I8 exists In the current catalog* or 
Is already local tc the Job. If neither of these cases Is true* 
then CY8ILIB wust be ACQUIRE'd from the catalog which contains 
the desired version. The same assumption holds for IIBLCB* 

The changes to be to the VELDCH file are described below. 
Imified i atel y after the directives! 

lOADJOB STSX 
directives of the formats 

tOAClIB NS PNAHE 
should be placed. There should be one directive per user task 



{i.e.f one per user task LINK command In 
NS parameter value must be the same as the 
the NS parameter on the LINK command. The 
any one to eight character name and Is the 
when it resides on the NQS/VE •library*. 



the VELDCH f I le). The 

value specified for 

value for PNAME may be 

name of this •program* 
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F2,0 ADDING USEI? TASKS TO NOS/VE 
F2,0,2 USING TH€ VE LINKER 



address ■ > + ' — — ■ — ^ ^ 

Page Table 



Moni tor 



Task 
Services 



Li brary 
Di rectory 



User 
Taskts ) 
CL ibrary ) 



Using the exanipie from above* the two directives to be added 
to the VELDCM file are: 

LOAOLIB LI8X PRQGA 
LOADLIB LIBZ PROGB 

The names PROGA and PRCGB can be whatever is desired* but must 
be unicfue within a single NOS/VE build. 

To execute PROGA* the following NOS/VE comnsand is usedi 

EXEC PRQGA »string« 

One final note about the VELDCM file. One of the last 
commands Is a ^^\^ ALL' con^mand which produces a hex dump of the 
virtual environment file* This command may be removed If the 
dump is not wanted* 

yhen using the VE Linker specifically to produce NCS/V6 
systems it is recommended that the procedure NVELINKt as 
described in the Advanced Systems Integration Procedures 
Notebook* be used to produce these systems* Use of any other 
procedures may lead to erroneous versions of interrelated 
software components* 
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F3.0 EXECUTION 



F3.0 glgQlUQU 



F3.1 miRmuQimu 

NOS/VE will run on eittier the C180 hardware or the sli«ul8tor» 
Any differences between the two are resolved by HOS/VE Itself or 
by the procedures used to run it* 

NOS/VE provides three different types of commands. The first 
type allows access to most of the software facilities within the 
systefn^ such as J 

Execution ?lanagefi?ent 
Logical Name Manageir^ent 
Task Hanagement 
File Hanagenient 
Segment H an age men t 
Hemcry Management 
Heap Management 
Signal Management 

The second type provides a debugging capability to be used 
within an executing task. The features available areJ 

Breakpoi nt 

Trace Sack 

Register Hanlpuiation 

Heaiory Manipulation 

Both of the first two types are available on both the hardware 
and the simulator. The third type of coirmand is available only 
on the hardware. These commands are processed by the PPU console 
drivert and offer the following features? 

Memory Manipulation 
Register Manipulation 
Print Memory 
OS Oispl ays (Dayf i I e ) 

NOS/VE currently supports a single job and multiple tasks 
within that job. A task may be executed synchronously or 

Bui Id N, June 1981 



F3-2 

NQS/VE USERS GUIDE 

07/29/81 



F3«0 EXECUTION 
F3.1 INTRODtfCTION 



asynchronoysl y with other tasks. 
F3*2 !II3SZ.M£-Q0I1MMS5 



NOS/VE cosnfliands allow the user access to a large number of 
functions provided by the system* In general* any parameter to 
one of these ccfflwands may be either an explicit value or a 
iogicai name space (LNS) variable. One exception to this Is the 
use of task status blocks or signal control blocks* which roust 
always be LNS variables. A logical nan^e space is associated with 
a job* a fact which inust be considered when running multiple 
tasks. 

The following types of LNS variables and parameters zre 
aval I ab I es 

INTEGER 

CHARACTER 

NAH€ 

BOO IE AN 

VSTRING 

POINTER 

SIGNAL CONTROL BLOCK (temporary for HCS only) 

TASK STATUS BLOCKS 

Withir the descriptions which follow* optional parameters are 
enclosed in square brackets (C 3). 



F3.2.1 DECLARE 

This command is used to create variables within the logical 
name space of the current job. 

Syntax! DECLARE NAHE TYPE 

NAME ~ LNS variable name* 1 to 31 characters. 

TYPE - Variable type* must be one of the followings 

INTEGER - A 64 bit integer. 

BOOLEAN - The value TRUE or FALSE. 

POINTER - A pointer to cell. 

SCB - A signal control block. 

VSTRING - A STRING (*) variable. 
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F3,0 EXECUTION 
F3«2*l DECLARE 



CHARACTER - A single character* 
TS8 - A task status block. 



F3*2,2 REMOVE 

This command Is used to remove a variable definition fron? the 
logical name space of the current Job* 

Syntax? REMOVE NAME 

NAME - LNS variable name* 1 to 31 characters. 

F3*2.3 PFSTATS 



This cofrmand is used to display the following page fault 
s t ati sti cs s 



avail Q 
avail mod q 
valid in pt 
no memory 

I eked 



on disk 
pt full 



CIO reject 
new page - 
syntax: PFSTATS 



Number of times a page was found in the 

available queue* 
Number of times a page was found in the 

available/modified queue* 
Number of times the page was found in the page 

t ab le* 

Number of times a page fault could not be 

satisfied because no real memory was 

available* 
Number of times a page fault could not be 

satisfied because the page frame was locked (10 

was active)* 
Nuf!5ber of times a page was found on a disk* 
Number of times a page fault could not be 

satisfied because an empty entry could not be 

found In the page table. 

Number of times a page fault could not be 

satisfied because of an I/O error. 
Number of times that a new page was created. 
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F3«2,4 TSTATUS 



F3*2.4 TSTATUS 

This conimand is usb6 to display the status of all currently 
active tasks* The following inforfaatlon Is displayed? 

Task Name 

Execution Time Used 
Number of page faults 

syntax! TSTATUS 

F3.2.5 THCYCLE 

This coni!!?and causes a task to give up its turn for execution 
until all other ready tasks have had at least one chance to 
ex e cute* 

syntax* THCYCIE 

F3,2,6 TMDEIAY 

This coffiinand causes a task to be kept from executing for a 
specified number of milliseconds* 

syntax: THDELAY MS 

MS - NufRber of milliseconds to delay. 

F3.2.7 TMABORT 

This conRwand causes the current task to be aborted* 
syntax: THA8QRT «MeS« 
li£S - A string to be displayed when the task Is aborted* 
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F3.2,8 THEXIT 

This command causes the current task to termir^ate normally* 
syntax? TMEXIT 

F3.2.9 EX£C/EX 



This coiRmand causes a new task to be created and executed 
subordinate to the current task* 

syntax? EXEC PROGRAM CPARAM3 CTSB3 

-or- 
EX PROGRAH tPARAH] CTS83 

PROGRAM ^ The name of the program on the system • library* to be 
executed* 



to the program via the 



PARAH - A string that is passed 
program header* 

TS8 - One of the foHowings 



DEBUG - Specifies that the task is to be 

executed by the debug processor* 
The task is run synchronously* 

A - Specifies that the task should be 

executed asynchronous I y> but 
without any task status block 
being used* 

Other non-blank - Specifies that a task status 

block variable of the name given 
is to be created in the current 
job*s LNS and the nei« task Is to 
be run asynchronously with the 
current task* The task name in 
this case will be the value given 
for this parameter* The user can 
determine the status of a task by 
printing the value of the task 
status block* 

If the parameter is omitted* the task will be run 

synchr onous ly • 
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F3,2*10 THTERH 

This cofflinaod is used to terminate a specific task ar^d ail 
callecs of that task. 

syntaxi TMTERM TASKNAHE 

TASKHAME - The name of the task to terminate* 



F3.2.11 SHOPEN 



This cofflffland causes a segment access open to be perfornsed on a 
local file* or causes a transient segment to be created. 

syntax! SMOPEN PVA CNAHE3 CSEGNUMI CR13 CR23 CATTR3 



PVA 



NAHE - 



SEGNUH' 



Rl 



Rl 



ATTR - 



The narj?e of an 
segment pointer. 



LNS pointer variable to receive the 



The name of the local file CI to 8 characters) to open 
as a segment. If this parameter is omitted* a transient 
segment is created. 

The segment nuif^ber to be assigned to the segment. If 
this parameter Is omitted* an unused segment number will 
be chosen. 



The Rl value for the segment, 
omitted* 11 is used. 



If this parameter is 



The R2 value for the segment. If this parameter is 
omitted* 11 is used. 



The attributes of the segment. A legal value 
valid combination of the following letters* 

R - Read 

W - Write 

X - Execute 

8 - Binding 

L - Execute Local Privilege 

6 - Execute Global Privilege 

I - Wired 

K - Stack 

C " Cache Bypass 



IS any 
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S - Shared 

Q - Sequential Access 

The defaylt is RW« 



F3.2.12 SMCLQSE 



This conimand causes a segment of the cyrrent task to be 
removed from that task's address space. 

syntaxs SMCIOSE PVA 

PVA - A pointer to a cell* The segnient represented by this 
pointer will be closed. 



F3.2.13 SMCHANGE 



This comtnand a Hows sojse of a 
changed after it has been created. 

syntax? SMCHANGE PVA CR13 CR21 CATTR3 

PVA - Safl^e definition as SMOPEN 

Rl - Same definition as SHOP EN 

R2 - Same definition as SMCPEN 

ATTR - Same definition as SHQPEN. 

F3.2.1^ HHADVI 



segments attributes to be 



This command causes the system to be notified that the 
specified range of virtual memory should be paged in as soon as 
possible. 

syntax: flMAOVI CPVA3 CLEN3 

PVA - A pointer to the first byte of virtual memory to be paged 
in. The default is NIL. 

LEN - The number of bytes to page in. The default Is 1. 
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F3.2*15 HHAOVO 

This command notifies the system that the specified range of 
virtual ii^eR^ory way be paged out (reiROved from the working set)* 

syntax: r^MADVO IPVAl CIENI 

PVA - Same as in MMAOVIf except that fl^emory is paged out* 

LEN - Same as in MMAOVIj except that peroory is paged out. 

F3,2*16 Hf^AOVOI 

This command performs the functions of both the HHAOVO and 
Hi^ADVI commands* The page out is performed first. 

syntax! HHAOVO tPVAGI CLEN03 CPVAU CLENn 

PVAQ - Same as in HHADVC* 

LEND - Same as in HHAOVO* 

PVAI - Same as in HMADVI* 

lENI - Same as in MMADVI* 

E3*2*17 HHWMP 

This command is similar to the MMADVO command except that the 
pages are written to disk immediatiy. 

syntax? mm? CPVA3 ClENl CWAIT1 

PVA - Same as MMAOVO. 

lEN - Same as MMAOVO. 

WAIT " The value TRUE if the user desires to wait until all 
paging I/O is complete* otherwise FALSE* The default is 
TRUE* 
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FB.Z.ie HHFREE, 

This con5B?ar>d causes the pages representing the specified range 
of vlrtufJ r.emory to be released. 

syntax: HHEREE PVIi CIEN3 

PVA - sasie as in HMAOVI. 

LEH - same as in HHAOVI. 

F3,2.19 CONPVA 

This command converts a process virtual address (PVA) to a 
real n^emcry address (RHA). 

syntax: CONPVA PVA CflODEI 

PVA - The pointer to be converted to an RMA» 

flODE - One of the following values: 

DIRECT - The specified PVA is to be converted. This is 
the default value. 

INDIR - The specified PVA is a pointer to the PVA to be 
converted. 

F3.2.20 HPINIT 

This command causes a heap to be created and initialized* 

syntax: HPINIT HEAPP LEH 

HEAPP ~ The name of an LNS pointer variable* It wiH be set to 
point to the heap. 

LEN - The length of the heap in bytes. 
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F3.2.21 HPAilOC 



This command allocates space within a previously created 
heap* 

syntax? HPALLOC PTR LEN CPAGECR0S3 CEERQ3 HEAPP 

PTR - The name of an INS pointer variable* It will be set to 
point to the allocated area* 

LEM - The nynjber of bytes to allocate* 

PAGECROS- This parameter has no affect. It Is included for 
coB?patib 1 1 i ty* 

ZERO - The value TRUE if the allocated area is to be preset to 
the value zero or FALSE if it is to be left as is* 
The default is FALSE* 

HEAPP - A pointer to the heap in Mhich the space is to be 
a I located. 



F3.2*22 HPFREE 



This comnnand frees a block of space previously allocated from 

8 heap* 

syntaxJ HPFREE PTR HEAPP 

PTR - The naine of an LNS pointer variable which points to the 
block to be freed* 

HEAPP- A pointer to the heap in which the block is allocated* 



F3.2.23 SHINIT 

This command is used to initialize a signal control block* 

syntax! SHINIT SCB CTYPE3 CVSTRl 

SCB - The name of an LNS signal control block variable to be 
initial ized* 
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TYPE - Ihe signal type to be associated i^ith the SCB» Hyst be 
one of the fell owing J 

EVENT 

smE 

IGRESP 

MIESSAGE 

VSTR - If TYPE is messagef then this parameter specifies a string 
variable whose size Is the rnaxiinuin message size allowed 
when using this SC6> and whose location is mhere the data 
will be p I aced. 



F3,2,24 SHSENO 



This cofBmand causes a send signal operation to be perforiaed on 
the specified signal control block* 

syntax! SHSENO SCB CINT3 C«STR»3 

SC8 - The LNS signal control block variable to which the signal 
i s sent* 

INT - Integer value to be sent with the signal 

STR - A string (in quotes) to be sent as data along with the 
signal* If both INT and STR are specified* STR takes 
precedence* 



F3*2*25 SHVIAIT 



This command causes the current task to wait until a specified 
amount of time has passed* or until any of up to three signals 
are sent* 



syntaxs SHWAIT CITIME3 CSCBl] 150823 CSC833 

ITIHE- The nuniber of milliseconds to wait* If this parameter is 
omitted* infinity is used* 
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SCSI - Up to tiiree LHS signal control block variables to wait for 
a signal on* 



F3.2»26 CHANGE INS VALUE 

This coBifiiand allows the value of an INS variable to be 
changed* Signal control blocN and tasK status block variables 
cannot be changed* 

syntax: LNSN « NV 

LNSN - The name of the LNS variable to be changed* 

NV - The new value* 

F3*2*27 PRINT INS VALUE 

This coiismand causes the value of an LNS variable to be 
d i spl ayed* 

syntax? LNSN 

LNSN ~ The nan?e of the LNS variable to be displayed* 

F3*2*28 FCHOINP 

This coiiift?and causes all comffland input to NOS/VE to be echoed 
back to the output device* This comroand is useful only when used 
as the first command to a batch mode simulation* 

syntax? ECHOINP 
F3,2*29 STOPSIM 



This comirand causes NOS/VE to stop execution via a CPU halt 
when running on the simulator* 

syntax? STOPSIM 
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F3,2,30 SS€T 



This coffljTiand allows some of the NOS/VE control parameters to 
foe changed dynaniicaHy# 

syntsxs SSET CPN CHV3 

CPN - The name of the control parameter being changed* The value 
fflust be one of the following Tentries followed by an * are 
not intended for general use)? 

QUAHTUM - Basic task time slice {microseconds) for all 
tasks created after the execution of this 

conifliand* 

HAXIOIE* - H3xl!!5un' amount of tiffie spent in unonltcr Idle 
loop before looking for lost interrupts* 

TICKTIME*- Used for paging control. 

DfOELAY* - Hinlniyn! amount of time between the issuing of 
dayfile messages* Used to slow down the 
scrolling action of the console dayfile 
dl sp I ay* 



KEYMAX 



STEPCNT* 



DBRING 



Maximui^ value of the id field from a keypoint 
that will be placed In the keypoint buffer* 
Any keypoint with an Id field greater than 
this value will be ignored* 

Haxiffuw number of monitor requests allowed 
before monitor goes into wait loop* 

Lowest ring that can be executed while in 
debug mode* 



POTHRESH*- Number of pages kept in the page queues* 

KM 



I^M 



UM 



- Keypoint mask used for every task created 
after execution of this command* 

- Monitor mask used for every task created 
after execution of this command* 

User mask used for every task created after 
execution of this command* 
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PITVAL* - The value that the PIT Is reset to after 
every PIT interrupt. 

0IS06LAY - How often <mllllseconds) the system status 
display C3 lines on the console) Is updated* 

NV ~ The new value for the specified control parameter. If NV 
Is emitted* the current value will be displayed. 

It Is Important to note that these commands are used primarily 
for hardware and monitor dehugging and may change or disappear at 

any time* 



F3.2.31 FMCREATE 

This coiDmand makes a file known to the system* 

syntax? FHCREATE FILENAH€ 

FILENAME ~ The name of the file being created (1 to 8 
characte rs) • 

F3*2.32 FHDELETE 

This command deletes a file previously made known to the 
system with the FHCREATE command* 

syntax! FMDELETE FILENAME 

FILENAME - Name of the file being deleted* 

F3.2.33 FHDOWNAU 

This command identifies bad areas on disk and keeps them from 
be ing a i located* 

syntax: FMDOWNAU UNIT CYLINDER TRACK SWLBUG SECTOR 

UNIT - Unit number of the disk device* 

CYLINDER - Cylinder number* 
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TRACK • Track nywber. 

SyLBUG - This parameter is present because of a compiler 

bug* 

SECTOR - Sector to be marked as bad within the specified 
unit/cyf Inder/track. 



Conijnands to the system are entered via the consofe keyboard. 
With the exception of aiessages to the operating system* ail 
com!T>ands entered must Include a two— character cofp^nand identifier 
or a two-character operating system display Identifier* Some 
commands re<?ulre parameters* others do not. AH command input 
lines are restricted to 60 characters or I ess | all are terminated 
by depressing the carriage return key. 

F3.3.1 DISPLAY CENTRAL f^EHORY 

F 3 . 3 . 1 . 1 M5£lii-r-£i£iiii-llail£ 

The following commands provide display of only the right-most 
60 bits of central memory words <they use the 60 bit PPU cm 
read/write instructions). 

F3. 3. 1.1.1 DP»<AODRS> 

Displays an installation-specified number of central memory 
words? two words are displayed per display line along with the 
byte address of the left-most word of the line. 

<addrs>s A 1-8 digit hexadecimal ££ji_2!^lfl£X_i2li£-JiJjS3£55S which 
defines the first M2L^ to be displayed. The specified 
address is forced to zero module eight if it Is not so 
specified by the command* 

F3.3.1.1.2 DP»+ 

Increments the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed. This command is used to **roll" forward 
through memory. 
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F3.3.1.1,3 d?$- 

Decrements the mcst recently specified memory address and 
displays a set of memory words «hicli are contiguoys with those 
most recently displayed. This command Is used to "roll" backward 

through memory* 

F3.3.1.1*4 DP 

This coffiBiand njay be uset^ to reinstate the most recent central 
meffiory display after the screen has been used for other 
purposes* 

F 3 . 3 • 1 • 2 £li5£lai«=-£Mil.MiJilS 



The following cojTJmands provide display of all 64 bits of 
central fflemory Nords* There are a number of characteristics of 
these commands of which the user should be awares 

These commands use the 64-blt central memory access 

mechanism. 

F3.3,1.2.1 OFf<ADDRS> 

Displays an Installation-specified number of central memory 
words! two words are displayed per display line along with the 
byte address o^ the left-most word of the line* 

<addrs>5 A 1-8 digit hexadecimal £JB5i«fliSifi£^«iiit£_Jilil055 which 
defines the first laxij to fee displayed* The specified 
address is forced to zero module eight if it Is not so 
specified by the command* 

F3.3.1.2.2 DF,+ 

Increments the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed* This command is used to "roll" forward 
through fPemory* 

F3*3.1.2*3 DFf- 

Decrements the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed* This command is used to "roll" backward 
through memory* 
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F3. 3. 1.2.4 OF 

This con^fliJand juay be used to reinstate the roost recent central 
meirory display after the screen has been used for other 
purposes. 



F3.3.2 CHANGE CFNTRAi HEHORY 
F3,3.2.1 £l25DSl£r£l£Jtial-l2i2il£ 

F 3. 3. 2. 1.1 CP*<ADDRS>*<VALUF> 

This coji5i!iand inserts a specified value into the right-ii?ost 60 
bits of a 64-bit central memory wordl the left-most 4 bits of the 
central memory word are unconditionally set to zero. 

<addrs>! A 1-8 digit hexadecimal ifiai«fflSia£^«|^j£l£.jii4lSSS which 
defines the central memory USIL^ which is to be 
modified. The specified address is forced to zero 
fliodule eight if it is not so specified by the coroirsand. 

<v3lue>5 A 16 digit hexadecimal value which is to be inserted 
into the central memory wordj all 16 digits must be 
specified. Blank characters may separate hex digits if 
desired to simplify value specification! for example* 
the two value specifications shown below yield the same 
resu 1 1 s 

valuel 0123456789A8CDEF 
value2 0123 4567 89AB COEF 

F 3 . 3 , 2 . 2 Lh^nQ^zEuil^Ms^^ 

F3. 3. 2.2.1 CF»<ADDRS>«<VALU€> 

This command Inserts a specified value into the full 64 bits 
of a 64-bit central memory word. 

<addrs>J A 1-8 digit hexadecimal ££Ji«ifiaiii£l.j2lX£»flilji£fiS5 which 
defines the central memory Mfi£iJ which is to be 
modified. The specified address is forced to zero 
module eight if It is not so specified by the command. 

<value>! A 16 digit hexadecimal value which Is to be Inserted 
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into the central memory «ord| all 16 digits must be 
specified. Blank characters fflay separate hex digits if 
desired to simplify value specification; for exapiplet 
the two value specifications shown below yield the same 
r esu It 8 

vaiuel 0123456789A8C0EF 
value2 0123 4S67 89A8 COEF 



F3.3.3 PRINT CEHTRAi HEMQRY 
F 3 • 3 • 3 . 1 mLiM^LS.lAi.MQ.tim 

This co!!5wand provides a listing of central fnemory to a line 
printer* Four words are listed per line along with the byte 
address of the left-most Mord of the line. 

<addrs>s A 1-8 digit hexadeciiial tsal-lfilSCX-feXi^-lililiSa^ which 
defines the first central memory M2L^ to be listed* 
The specified address is forced to zero fl?odule eight If 
It is not so specified by the command. 

<words>3 A 1-5 digit decimal value which specifies the number of 
central memory words to be listed. 

A listing operation may be terminated prior to its normal 
completion by depressing the carriage return at the keyboard. 

F3.3.4 DISPLAY/CHANGE SYSTEH ELEMENT REGISTERS 
F 3 . 3 . A . 1 Cll£iSl-£l£m&Ili.££iliSi££l 

F3.3.4.1.1 DR#<£LID> 

This command causes display of an installation defined set of 
registers of a system element. 

<elld>i A two-character system element identifier which 
specifies the element of which registers are to be 
displayed. Valid system element identifiers are listed 
under the section entitled "System Element 
Identifiers". The registers displayed for each system 
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el Client are listed under the section entitled •*Systero 
Element Registers'*. 



F 3 •a . 4. 2 £l2J2i3S-.£l£i£at-E£<alslS£S 



F 3. 3, 4, 2.1 CR#<ELIO>f<REGID>«<VALUE> 

This command permits modification of system elei^ent registers 
for which the maintenance channel has write access. 

<elid>? A 2 character systeni elefnent identifier *«hich specifies 
the elenient of which a register is to be modified. 
Refer to the section entitled "System Element 
Identifiers" for a list of valid identifiers. 

<regid>J A 1-4 character register identifier which specifies the 
register which is to be modified. Refer to the section 
entitled "System Element Registers" for a list of valid 
register identifiers for each system element. 

<value>s A 16 digit hexadecimal value which is to be inserted 
Into the register; all 16 digits must be specified. 
Blank characters may separate hex digits If desired. 

F 3 « 3 . 4 . 3 Sl5i£l-£iSl£at-Iil£C tit i££JS 



Following is a list of valid system element Identifiers* 

• H2 Identifies the central memory element 

• P2 Identifies the central processor unit 

F 3 . 3 . 4 . 4 llsiSl«£l£i£nt«E£iai5i£t& 

The following subsections list* according to system element* 

those registers which may be displayed and which may be modified 

(assuming that the maintenance channel has write access to the 
specific register). 

F3. 3. 4.4.1 CENTRAL H£?10RY REGISTERS 
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<mnm tmmtMttmmtmtummntiifU'iniumtmtintuHt Mtmrnit mt i 



REGISTER 


MN€HQNIC 


SS 


EC 


6R 


CEIO 


UCIO 


UC20 



REGISTER NAME ACCESS 

ATTRIBUTES 



SS Status Summary 

EC Environment Control 

P ProsraiB Address 

HCR Monitor Condition Register 

UCR User Condition Register 

UP Untranslatable Pointer 

JPS Job Process State 

PES Processor Fault Status 

CELl Retry Corrected Error tog 

CEL? Control Memory Corrected Error Log 

CEL3 Cache Corrected Error Log 

CEL4 Hap Corrected Error Log 

KC Keypoint Code 

KCN Keypoint Class Number 

TE Trap Enables 

SIT System Interval Timer 

CHA Control Memory Address 

CMS Control Memory Breakpoint 

PTM Processor Test Mode 

MOW Model Dependent Word 

DEC Dependent Environment Control 

MSL Maintenance Scan Limit 



F3.3.5 DISPIAY PPS PROGRAM ADDRESS REGISTERS 



Status Summary R 

Environment Control R/y 

Sounds Register R/y 

Corrected Error Log* Distributor R/W 

Uncorrected Error Log 1# Distributor R/y 

Uncorrected Error Log 2f Distributor R/W 

F3.3,4*4,2 CENTRAL PROCESSOR REGISTERS 

REGISTER REGISTER NAME 

MNEMONIC 



ACCESS 


ATTRIBUTES 


R 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 


R/y 
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F3,3.5.1 ?? 



F 3*3* 5,1 ££ 



This cofflffland causes display of the prograrR address register of 
each PPU in the PPS. 



F3«3.6 CLiAR DISPLAY 
F 3. 3. 6,1 £Oi.iSii£fita^ 

This command is used to deactivate a currently active 
d i spl ay. 

<screen>s is L# R^ or 8 to specify left screen* right screen* or 
both screens* respectively. 

F3,3.7 START SYSTEM 

F3.3,7.1 ^^ 

This command is used during system deadstart after the iisessage 
"PROCEED" is displayed at the console! this coii?mand causes final 
initialization to occur and the CPU to be started* The command 
is valid at no other time* 

F3.3*8 HALT CENTRAL PROCESSOR 

F3*3*6*l ai 

This command is used to halt the central processor* 

F3.3*9 START CENTRAL PROCESSOR 
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F3,3«9,l ga 

This coipiuand is used to start the central processor after it 
has been halted with the HT command* 

F3.3.1G OPERATING SYSTEM DISPLAYS 

Various operating system displays are available to the 
console! a specific display may be called by typing its unique 
2-character identifier and a carriage return. 

F3 .S. lO, 1 CiS£llJe-IilSBJ;lfi£X5-Jlli.0£Sfi£iEtifiX3S 

DD - Dayflie of the system job. 
F3.3.11 CONSOLE HESSAGES TO THE OPERATING SYSTEM 



Single line n^essages of 60 characters or less may be sent to 
the operating systeir fron? the console keyboard. Any line of 
Input from the keyboard is sent to the operating system if both 
of the following conditions are metJ 

1. The first two characters of the line do not match a console 
command or an operating system display identifier. 

2. The number of characters in the Input line equals or exceeds 
1 character* 



F3.4 Mfiy£^Fi£ILiIX 



The debug facility of NOS/VE provides a set of capabilities 
intended to assist in testing of programs which execute under 
control of NOS/VE. Services provided by the facility are task 
crientedJ selection of the debug facility Is at the option of the 
user at the time of task Invocation. NOS/VE uses the CYBER 180 
debug hardware to provide these capabilities. 
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F3.0 EXECUTION 

E3*4.1 SUMMARY OF DEBUG FACILITY SERVICES 



F3.4.1 SUHMARY OF DEBUG FACILITY SERVICES 



Set Breakpoints 



Remove Breakpoints 



Change Breakpoints 



L I st Breakpo i nts 



Trace Backs 



i spl ay Stack Frame $ 



Di spl ay Regi ster s 



Change Registers 



Di spl ay f^emory s 



Change Memorys 



Runs 



Selects a prograni interrupt which Is to 
occur upon occurrence of a specified 
condi 1 1 on w i thin a specified virtual 
address range* 

Deselects a previously selected prosran? 
i nterrupt. 

Changes the virtual address range of a 
previously specified breakpoint. 

Provides a list of currently selected 
breakpoints and associated conditions* 

Provides Information relevant to stack 
frames associated with an interrupted 
procedure and its predecessor 
procedures. 

Display selected information from a 
specified stack frame. 

Display the contents of a specified 
register of an Interrupted procedure. 

Sets a specified value into a specified 
register of an interrupted procedure* 

Displays the contents of a specified area 
of virtual memory. 

Sets a specified value into a specified 
location of virtual memory* 

Invokes program execution after a 
selected program interrupt has occurred* 



F3.A.2 DEBUG FACILITY COMf^ANOS 
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F3,0 EXECUTION 

F3«4*2«l Parameter Definitions 



E 3 • 4 * 2 . 1 £ J£J15i££.Ds£iallii^i3S 



<nafl?e> is* 1-8 character breakpoint name 

<condition> !?« READJ«R ITEt RNI J BRANCHJCALl JOIVELT J ARIOSJ 

AROVElJEXOVFLSEXUHFLJFPtOSIFPIHOEFJINVSOP 
<base> 5 8* process virtual address 
<offs€t> 5J« integer 
<lengtli> JJ« integer 
<fra!i?e> S5« 1»«100 
<count> JS« 1*«100 
<regid> it^ XIAIP 
<regno> 2S« 0* .ISJO ..OF C 16) 
<hex_vstr ing> 5S= *hex string^ 
<ti}i?e> :j« 1..<2**31)-1 
<vstring> !J* 'c^ar string' 
<datatyp€> st« HEX? ASCII J ASC JDECIHAl J DEC 
<selector> ss* FillL S AUTOJ SAVE 

F3.4.2.2 CfllllQJil-QfiJSfiLifiilXlGS 

yithin the descriptions which follow* optional parameters are 
enclosed in brackets* Default values for optional parameters are 
also defined. 

F3. 4. 2.2.1 SET BREAKPOINT 

Selects a prograii? interrupt which is to occur upon occurrence 
of a specified condition within a specified virtual address 
range. 

syntax? BP <nanie> <condition> C<base>3 C<offset>3 C<length>3 

The base parameter is required when specifying a new 
breakpoint namei offset and length specifications are optional In 
this case. When adding a new condition selection to an existing 
breakpoint* base* offset* and length parameters may not be 
speci f i ed. 

Base* offset* and length parameters define the desired virtual 
address ranges <b3se> + <offset> yields a f i rst-byte-address5 
first-byte-address + <length> -1 yields a last byte address* 

Default parameter values? 

<offset>J 
<l€ngth>s 1 
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F3*0 EXECUTION 

F3«4,2.2.2 REHOVE BREAKPOINT 



F3,4«2,2«2 REHOVE 8REAKP0INT 

Deselects a previously selected prograin Interrupt. 

syntax? RB <na!!ie> C <cond i t ion>] 

If only the nape parameter Is specified* all conditions 
associated witli the breakpoint are deselected and all evidence of 
the breakpoint Is removed* If the condition parameter is 
specif! ed# only that condition is deselected! however f if the 
specified condition Is the only condition selected* all evidence 
of the named breakpoint Is removed* 

F3.4.2.2.3 LIST BREAKPOINT 

Provides a list of currently selected breakpoints and 
associated conditions. 

syntax? L8 C<name>3 

If the name parameter Is specified* information Is displayed 
for the named breakpoint only. If the name parameter Is not 
specified* information is displayed for all currently defined 
hr eakpo i nts* 

F3.4.2.2.4 CHANGE BREAKPOINT 

Changes the virtual address range of a previously specified 
break po int. 

syntax! CB <name> <base> C<offset>3 C<length>] 

Base* offset* Bnd length parameters define the desired virtual 
address range? <base> + <offset> yields a first-byte-address* 
f i rst-by te-addr ess + <length> -1 yields a last byte address. 

Default parameter values? 

<offset>! 
<rength>! 1 

F3. 4. 2.2.5 TRACE BACK 

Provides Information relevant to stack frames associated with 
an interrupted procedure and its predecessor procedures. 



Information displayed for each selected stack frame consists 



of! 
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F3.0 EXECUTION 
F3.4.2*2»5 TRACE SACK 



- Stack frame number! 

- Current P-address of tJie associated procedurel 

~ Virtual address of the start of the stack frarpel 

- Virtual address of the stack frame save area* 

syntax? TB C<frawe>3 £<count>1 

The frame parameter specifies the number of the first stack 
frame for which Information is to be displayed. <Stack frame 
nyiiiber one Is associated with the interrupted procedure* stack 
fraiHC t**o is associated with the interrupted procedyre's 
predecessor^ etc*) 

The count parameter specifies the total nuinber of stack frames 
for which information is to be displayed* 

Default parameter value si 

<frai«e>s 1 
<count>s 1 

F3*4*2*2*6 DISPLAY STACK FRAHE 

Display selected information from a specified stack frame* 

syntax? OS t<frame>3 t<selector>] 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed* (Stack frame number 
one Is associated with the interrupted procedure* stack frame two 
is associated with the interrupted procedure's predecessor* 
etc.) 

The selector parameter identifies a region of the specified 
stack frame! 

AUTOS Causes the automatic region of the stack frame to be 
displayed* 

SAVES Causes the save area of ttie stack frawe to be 
displayed* 

FUtti Causes both the automatic and save areas of the stack 
frame to be displayed* 

Default parameter valuesi 

<fraroe>t 1 
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1=3 ^0 EXECUTION 

F3»4.2.2#6 DISPLAY STACK FRAME 



<sel6ctor>t FULL 

F3.4,2,2«7 DISPLAY RESISTeR 

Display the contents of a specified register of an Interrupted 
procedure* 

syntax! DR <reiiid> £<re9no>3 C<datatype>J 

Default parameter valuest 

<regno>t 
<datatype>i HEX 

F3,4*2*2.8 CHANGE REGISTER 

Sets a specified value into a specified register of an 
interrupted procedure. 

syntax! CR <reflid> <regno> £<datatype>3 <vstrlng> 

Default parameter values! 

<datatype>! HEX 
F3*4,2«2,9 DISPLAY «E«ORY 

Displays the contents of a specified area of virtual memory* 
syntax! DH <base> C<length>] 
Default parameter values! 

<lengtfi>! 8 
F3«4,2.2.10 CHANGE MEMORY 

Sets a specified value Into a specified location of virtual 

memory* 

syntax! CM <base> <hex.vstr lng> 

F3. 4. 2. 2*11 RUN 

Invokes program execution after a selected program interrupt 
has occurred* 

syntax! RUN <time> 
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F3.0 fXECUTION 
F3.4«2«2,ll RUN 



The time parameter specifies the mexinuiB number of 
microseconds the progran is to executei a program interrupt Hiil 
occur upon attaining this execution I Imi t« 

Default parameter valuesi 

<tiiie>i Infinite 

Error codes Bte displayed as 6 hex digits In the fol lowing 
format! 

AANNNH 

The AA field designates the functional area that Issued the 
error* The possible values aret 

01 - Signal Handler 

02 ^ Circular Buffer Handler 

03 - Heap Nanager 

04 - Hisc Task Services 

05 - N/A 

06 - File Manager 

07 - N/A 

08 - Task Nanager 

09 - Nemory Nanager 
OA - Joh Nanager 

OC - Loader 

00 - Central I/O 

0£ - Dispatcher 

Of - Command Language Processor 

10 - Logical Name Nanager 

11 - Debug Processor 

12 - Configuration Nanager 



The NNNN field Is a detailed error number Mithin the specified 
functional area* 



F3.5*l DETAILED ERROR CODES 

All numeric values are given In hex. 
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F3.0 EXECUTION 
E3*^*l*l Signal Handler 



E3«5.1,l SlimJl«MJIIiJll£ 



1 » tiffieout 

Z « signal buffer full 

3 « task snapped 

4 « I nv a 1 1 d signal id 

5 « Incompatible signal type 

6 « message buffer too small 

7 » eiRpty nal t list 



1 « buffer not initialized 

2 • buffer full 

3 » message too long 

F3.5.1.3 U&^B^BMUS^U^ 



None 
F 3 • 5 • 1 • 4 Ml££.Iasli.^fi£Jti££l 

None 



1 « KFD not available 

2 « File active 

3 « File not active 

4 « PFO not available 

5 « File exists 

6 » File not created 

7 « File open 

8 « Hultiple usage 

9 « File not temporary 
OA « File not permanent 
OB « File not attached 
OC « File attached 

OD « File not open 

Oe « Invalid KFOt Index 

OF « KFD not active 

10 « Invalid PFDL index 

11 « PFD not active 
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F3,0 
F3 *5 



EXECUTION 
1.5 File i 



anager 



12 « Active I/O 

13 « No units configured 

14 « Ho active units 

F 3 • 5 . 1 » 6 IJSJS.MJH J Jl£ 



1 « Task not found 
F3,f.l.7 MMQtX^U2QM2&t 

1 « Page already in page table 

2 « Page table full 

3 « No free pages 

4 « Locked page free request 

5 * Page not in page table 

6 « Invalid PVA 

7 » Page frawe not locked 

8 « Page fra«e not assigned 

9 - IE « N/A 

IF ■ Invalid ring number 

20 « Segfient table is full 

21 » Segment number Is In use 

22 « Segment number not In use 

23 « Nil segment pointer Invalid 

24 « Segment number too big 

25 « Cannot change segment number 

26 » Unsupported keyword 

F3,5,l«8 iuii-a^JQaflfiX 

None 

F3.5,l,9 iflidfii 

1 « program not found 
F3,5,1.1C djeflitaiaZQ 



1 » lORP not available 

2 « End of file 

3 « Invalid byte count 

4 « Invalid buffer length 

5 « Invalid buffer address 
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F3.0 EXECUTION 
F3.5.1.10 Central 



I/O 



6 
7 
8 
9-40 

41 « 

42 « 

43 « 

44 * 

45 « 

46 « 

47 « 

48 « 

49 « 
4A - 
81 « 



Invat id 

Inva 1 id 

Eeature 

» N/A 

End of 

End of 



ns function code 
CIO hardware type 
not supported 



device 
allocation 

Fl I e not al located 

File already allocated 

Inval I d cyl inder 

Invalid track 

Invalid sector 

AUD not defined 

AUD allocated 

80 « N/A 

CBO not available 



F3,5«l.ll liS£ai£ll££ 



1 « Invalid task Id 

2 * PTL full 

3 « Invalid running Job ordinal 

F3,5.1«12 Q.MMMMQil^LMBBU&2£^2.ZU£Si^S^t 



1 « missing paraneter 

2 « invalid character 

3 « undefined parameter type 

4 « Integer out of range 

5 » unknoMn cownand 

6 • unknown syntax 

7 » not supported 

8 « bad parameter type 

9 « token too long 

OA « bad combination of parameters 
OB « bad value for pointer 
00 s unknown parameter name 
OD « valid password required 
OE ■ SC8 not event 

F3«5*1*I3 ij2Jli^JUtlJa£.BJfiJii££ 



1 « Entry not found 

2 « Type mismatch on put 

3 « Entry already exists 

4 » Illegal put request 
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1=3.0 EXECUTION 

F3«5«i»13 Logical Name Manager 



5 » Buffer Mrong size 

6 « Buffer too sfRal I 



I * Debug not Initialized 
Z * Breakpoint name exists 

3 « Base par aseter not specified 

4 « Invalid brealipoint condition 

5 « Condition already selected 

6 * KaxliRutR number of breakpoints already set 

7 « Invalid address range 

8 « Invalid breakpoint name 

9 « Condition not selected 
OA « No trap hms occurred 

08 'Invalid stack frame specified 
OC » Register not in stack frame 
00 « Invalid data type definition 
0€ « Invalid register type 
OF » Invalid P-reg value 

10 « Invalid A^reg value 

II • Invalid X*reg value 
12 « Invalid selector 
3«0FE « N/A 

OFF « Unused error code 

F3 .5. 1.15 gQIXllBUtMliUa^flMQA^t 



1 « Invalid function code 

2 « Hot mass storage 

3 ■ Unit not active 



F 3. 5. 1,16 ££y.l|QUlIIl£ 



These values Bre stored in register XE just before NOS/VE halts 
the processors 

1 » HardMare failure 

2 « Task aborted In ring 1 or 2 

3 * Task aborted Mhile abort In progress 

4 « Task executing had negative PIT 
301 • Hardware failure 



Build H, 4une 1981 



NQS/Ve USERS GUIDg 

07/29/81 

F4,0 CQOINS CONViNTIONS AND SOURC£ USAGE 



i" "^ . £||fiIM.i:OMJ^£MIliiiS.A!i£.iOilE££.lllA££ 



The eonvefitiofis presented In this section reflect the current 
state of the NOS/VE systew^ formerly knonn as the Hardiiare 
Checkout System CHCSI« The final NOS/VE systeai nil I differ f roe 
the current system In many tiaysf such as different functional 
areas» net* functional areasy different iiaiRlng conventlonsf etc* 
The conventions to tie used In the final NOS/VE systeiR are 
documented In the NOS/VE Project - Procedure and Conventions 
document* The Information presented in this section Is intended 
to assist users while HCS conventions are still In use* 



f4.1 Mi£i 

All global NOS/VE names have the foltoning formats 

AAT$NNN 

The AA field designates the functioiiai area to Mhlch the name 
applies^ and can be one of the folfonlngs 

SH - Signal Handier 

HP -" Heap Manager 

FH - File Manager 

PH - Task Manager 

MM ~ Memory Manager 

4M - Job Manager 

LL ^ Loader 

CI - Central I/O 

OS - Dispatcher 

Ct - Command Language Processor 

LN * Logical Name Space Manager 

08 - Debug Processor 

CM - Configuration Manager 

OS - General NQS/VE 

MH - Machine Code Breakout 

DM - Data Management 

MT ^ Monitor Interrupt Processor 

The T field represents the type of the namet and can be one of 
the following valuess 
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F4,0 COOING CONVENTIONS AND SOURCE USASE 
F4.1 NAHES 



P — Proceilure 

V - Variable 

E - Error Constant 

K - K«ypoint Constant 

The NNN field Is a descriptive string describing the object* 

F4.2 liJJlUHEyi 

NOS/VE contains a routine that alloMS text Input to be 
performed easifyt and without regard to whether eKecution is on 
the hardware or the simulator* Mhen running on the siiiuiator the 
system executes the 10 machine Instruction (opcode FE) which 
reads from the file specified on the I parameter when the 
simulator was called* When running on the hardware^ text Is 
input from the console* If more than one task attempts to read 
input at the same time when running on the simulator^ the *first* 
task will get the data* If this happens on the hardwaret any one 
of the tasks may get the data* 

The name of the routine Is CLFSGET.STNO^INP and has the 
following declarations 

♦call RCtGETS 

The variable cstring contains the input text and is defined as 
followst 

RECORD 

LHI^RHI t 0.,255# 

S I STRING (255lf 

RECENDl 

The LHI field points to the leftmost character of the string* 
Any number of blanks may precede the first character of the 
string* A semicolon will be added as the last non blank 
character of the string and the RHI field will point to the 
semicolon* 

NOS/VE contains a routine that allows text output to be 
performed easiiy# and without regard to whether execution is on 
the hardware or the simulator* When running on the simulator^ 
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F4.0 COOIH€ CONVENTIONS AND SOURCE USA0E 
F4,3 TEXT OUTPUT 



the system executes the 10 nachine Instruction {opcode FEt which 
Hfltes to the file specified on the paraiieter when the 
simulator was called* When running on the hardwaref text is 
output to the dayfiie» which Is scrolled on the console screen* 
If more than one tasfc outputs to the consolet the outputs will he 
intemixed* HOS/VE does not Identify the output as to which task 
issued it* 

The na«e of the routine Is CLP$i>UT«$TNO^OUT and has the 
following declarations 

♦caii RCtPUTS 

Note that the string S Is a VAR paranetert and as such» a 
literal string cannot be passed* 



F4.4 £OliMMfi.ilIIUIIfl 

NOS/VE contains various routines that will aid In the process 
of cofRmand cracking* The user could read a line of text Input 
via CLPSGET^STNO.INP and then use these utilities to crack the 
conmand line* The following capabilities are avallahlei 

CLP$CRACK_COHHANO - 

This routine uses a parameter descriptor table to crack the 
syntax of a command* A paraneter value table Is built specifying 
the actual values from the command* 

CLPSGET.TOKEN - 

This routine returns the next token from a command string* 

PNPSASCII.TO.BINARY « 

This routine converts an ASCII string to a binary value* 

PNRSBINARY.TO^ASCIl - 

This routine converts a binary number to Its ASCII 
representation* 

For more information on these routines^ see a current source 
I i sting of them* 

There ^rt two ways to use these routines* One way would be to 

Build Nf June 1981 



HOS/VE USERS 6UI0E 



F4-4 
07/29/81 



F4*0 COOING CONVENTIONS AND SOURCE USAGE 
F4,4 COWMAND UTILITIES 



Mf ite a user task program Ntiich called on thein directly* The 
second May is to modify the NOS/VE coswand language interface 
(routine CLR$J08.COHHANO_RROCESSORI to process the desired 
coiiiiands* This second method night reiRoye the need for a user 
taste program to aid In progr an checkout* 

NOS/VE provides a set of routines Hhich externalize certain 
hardware instructions to a CYBIt program* These routines are 
described fully in a DAP uritten by Jack Stelner* 

When a user task is executed via the EXEC commands the text 
string portion of the command is made available to the program* 
Alsof the program can set the status return variable and have it 
displayed by the system at task termination* 

This communication Is performed via the parameters of the 
PRQGRAH statement# Mhlch has the foilOMtng formats 

PROGRAM NAME IP I '"STRING <255l| 
SL I 0**40961 
VAR STATUS t OST$STATUSI| 

The P parameter points to the string specified on the EXEC 
commandf and St is the length of the string* For internal 
program calls# P can be declared as a ^CELt and then any 
structure can be passed* 

F 4 * 6 £13l!ll£lli.MCK«iUl!liig.££lM£MlIIiMl 

The general format of a NOS/VE common deck name Ist 

XAANNNN 

The X field denotes the type of deck and is one of the 
folloningi 

T - TYPE/CONST deck 

R - Procedure XREF deck 

The AA field denotes the functional area the deck d^als iiith* 
The field may take on the same values as the AA field described 
in section 5*1* 
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F4.0 COOING CONVENTIONS AND SOURCE USAGE 
E4.6 COMMON DECK NAMING CONVENTIONS 



Tlien NNNN field contains the first foyr cfiaracters of the nawe 
of the I te« the deck represents* For XREF's It Is the first four 
characters from the desor Iptive part of the naney Ignoring the 
characters P$» i and .• For a TYPE/CONST deck the vafye mIM be 
TYPE. For a TYPE/CONST deck defining tables the value hI 1 1 be 
T8LS. 

Sone examples Mould be* 

Deck name rmconpa from miconpare.sMap* 

Deck name rclputs from name clpSput^stnd.out. 

F4,7 ll3£MIliiI-£BI!!lfilL.M£MS 

The follonlng NOS/VE common decks are northy of notei 

TOSTYPE - General OS definitions* 
THD«TYP - Hardnare structure definitions* 
TMMTYPE - Memory management definitions* 
TSMTYPE - Segment management definitions* 
TCLTYPE - Command language definitions* 

F4.8 £I£ii.U5AM 

The follotting rules apply nhen using NOS/VE common deckst 

1) TYPE/CONST decks Include all necessary keytiords and end iilth a 
semicolon* 

2} Procedure XREF decks end tilth a semicolon* Other common decks 
may be required to define the types for the parameters 
sped fled* 

3) Variable XREF decks do not contain the VAR keynord and end 
Kith a comma rather than a semicolon* Both the VAR keyword 
and ending semicolon must be supplied In the surrounding 
text* Other common decks may be required to define the type 
symbol* 
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F5.0 KEYPOINTS 



F5.0 mitQlBU 



Keypoints are use<l to give an execution tine trace of i>ro9ra« 
fiOM by shOMing that a given function is being perfor«iecl (i«e«9 
tfiat a given procedure is being executedl* Keypoints are aiso 
used to display request parametersf status and error conditions* 



f^*l ^U££i.lIOiI.£aiMiMIlfiM 



The general format of the source statement used to generate a 
keypoint from a CYBIL program iss 

fINlINEC •KEYP0INT«#$ECTIQN#DATA*256#I0)| 

The SECTION parameter identifies the functional area that Is 
issuing the keypoint* It must be in the range I to 15* The 
foiioMing values are currently defined! 



data from the previous 
trap may not at ton this 



reserved for 



« Denotes a continuation of 

keypoint Ithe occurence of a 
feature to work correctlyl* 

1 « System Information CID numbers 1-63 are 

use by assembler code routinesi COSK$} 

2 « Hemory Manager IMMK$) 

3 « Cpmmand Language ICLKSI 

4 « Debug (DBK$) 

5 « CIO CCIKSI 

6 » File Hanager {FHK$) 

7 « Task Services ITSKSI 

8 « Dispatcher (DSKS) 

9 « Unused 

10« Job Manager (JMKS) 
11* Signal Handler ISHK$I 
12« Loader ILLKSI 
13-15 « Unused 

The DATA parameter can be any 24 bit or less integer value# 
and is normally used to display data that relates to a particular 
keypoint* The value must be shifted left 8 bits Imultiplied by 
256) so that it Mill not overlap with the ID value* 
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F5*0 KEYPOINTS 

f=5,l SOURCE CODE CONVENTIONS 



The ID psrameter Is used to identify the iceypoint tilthin a 
section* The vaJye must he in the range to 255* Vaiues less 
than 31 are considered critical^ ynexf>eoted# un<isyal# etc* 

A yser »ay add his own Iceypoints hy ysing section 15 Kith 
a{>prof»r iate DATA and ID valyes* 

A circytar hyffer of the last 200 keypoints is maintained in 
memory* These nay he displayed on the console using the 
foitoMing commandi 

OH <reai memory address of the hyffer> 

The hyffer Is defined by the symbol OSV$KEYPOINT_BUFFER# which 
Mill appear In the LINKNAi> where the monitor tables are defined* 
The real memory address Is compyted by adding the address of 
QSVIKEYPGINT^BUFFER to the length of the page table Imonltor 
tables folloM the page tablel* 

Keypoints prodyced on the hardware are not nearly as ysefyi as 
simylator keypoints becayse only the last 200 are ayallable and 
they are displayed in an ynedited format (l*e«» a hex memory 
dympK However^ they can be ysefyi in showing the seciyence of 
events leading yp to a system crash* 

The format of the keypoint byffer is an array of words with 
each word having the following formati 

Left 28 bits - Valye of free rynning microsecond clock when the 

keypoint occyred* 
Next 4 bits - Keypoint class 
Next 24 bits - Data valye. 
Next 8 bits • Keypoint Id valye 

F 5 * 3 jlS£I£iUl!iI«£iIA.lllIti£.Itl£ JSiIliyUIi2£ 

When execyting on the simylator* all keypoint instryctlons 
cayse an entry to be added to the local file SESSNKF* When 
execytion Is completOf this file may be processed by a ytility 
program to prodyce a listing of the keypoint information in a 
readable format* 



Byild H, Jyne 1981 



F5^3 
NOS/VE USERS SUIDE 

07/29/81 



F5.0 KEYPQINTS 

F5.3,l KEYPOINT REFORHATTINS UTILITY 



E5*3*l KEYPOINT REEORHATTING UTILITY 



Th€ SiSSHKE fi l« produced Isy tht simiitator ean be reforiRatted 
into a readable fisting by execyting the foltoiiing procedyrei 

SES.HVEKEY CKPE« 1 CEORHAT* I lAREA- 3 

The 8 parameter^ if presetitt cayses the Pfooedure to be run as 
a batch Job* 

The FN parameter specifies the na«ie of the file containing 
tceypoint data* The default is SiSSMKF, If this file is not a 
local f lle» or the procedure is running In batch «ode» the file 
Mill be obtained from the current catalog* 

The PR parameter^ If present* causes the reformatted listing 
to be sent to the printer* 

If run interactlyeiyf when the procedure terminates the 
reformatted listing is on local file KEYFILE* 

The RNVEKEY procedure requires two additional files as Input* 
The first file defines hott the Iceypoint Inforaiation is to be 
reformatted* The name of this file is KEYOESC and It Is obtained 
from the current catalog or# If not present theret from the 
HQS/VE catalog* The format of this file Is described In section 
6*3*2* 

The second Input file provides direct Iwes to the utility 
program nhich direct Its execution* The following directives are 
supported! 

CV MAXPROCIO N 

This directive causes all keypoints with Id values greater 
than N to be ignored* 

CV UNOEFINEO 

This command causes both defined and undefined keypoints to be 
printed* An undefined keypoint Is one that does not have a 
definition In the KEYOESC file* 

CV DEFINED 

This command causes only defined keypoints to be printed* 
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CV lOiNT 

This command causes the Neypoint processor to indent ttie 
output produced based on the NS field of the KEYDESC file* 

RUN 

This command causes the processor to make one pass OYer the 
keypoint file. It Is used after the CV commands have specified 
how to process the keypoint information* 

END 

This command terminates the keypoint processor* It must he 
the I ast command* 

These directives are read from file RNQSKEZ* This file Is 
obtained from the current catalog ort If not found there* from 
the NOS/VE catalog* 

F5.3*2 KEYPOINT DESCRIPTION FILE 



The keypoint description file is used by the keypoint 
reformatting utility to direct the reformatting of the keypoint 
information* Each line In the file describes one keypoint* and 
has the following formats 

SIO SCN PIO LN F LEN FHT CSTR NS OT 

The SID field represents the section ID and is 2 characters 
long* An example would be NN for memory manager* 

The SCN field is the section class number* which equals the 
SECTION value from the keypoint Instruction* 

The PID field is the procedure ID* which equals the ID value 

from the keypoint instruction* The SCN and PID values uniquely 

define a keypoint - all of the other information Is useti for 
reformatting* 

The LN field Is used to cause a line on the keypoint listing 
to foe preceeded by a * If the LN value Is zero* This feature is 
used to mark a given keypoint as special* 

The F field specifies that this Is a special keypoint li*e** 
has special meaning to the program that formats the keypoint 
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F5.0 KEYPOINTS 

F5.3.2 KEYPOINT DESCRIFTION FILE 



fll«l» Ttie values «yst be one of the follonifigs 

* Not sf>eciai 

1 - T«si< switch 

2 ^ Begin trap 

3 - End trap 

4 - Begin won I tor 

5 • End monitor 

Any new keypoint deseriptlons should specify this field as 
zero unless the utility program Is Modified to handle the nen 
valuers)* 

The i£N field specifies the length of the data portion of the 
tceypoint In bytes* 

The EMT field specifies In what format the data portion of the 
Heypoint should be displayed^ and can be one of the follonlngi 

¥ - Hex 

I ^ Integer 

A - ASCII 

The CSTR field is a 1 to 8 chafacter string describing the 
data portion of the keypoint* 

The HS field specifies the number of spaces to indent the 0T 
string on the reformatted file* This feature can be used to shoN 
procedure nesting via keypoints* 

The OT field is a text string that describes the purpose of 
the keypoint* It may fill the rest of the current line* 

The user may add his oun keypoint descriptions to this file 
and save It In his catalog* When RNVEKEY Is run# the existing 
NOS/VE keypoints and user defined keypoints Mill be listed 
together* If the NOS/VE keypoints are not wanted* their 
descriptions may be deleted from the file* 

E5.3.3 REFORMATTED FILE DESCRIPTION 



The reformatted listing fife contains two sections* The first 
is a summary of the number of times each keypoint occurred* The 
second section is a listing of al I the keypoints In the order 
they were Issued* Each line of the second section has the 
following formats 
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F5,3»3 REfQRHATTiO FIt€ OESCf?IPTIQN 



RT TSL DATA CSTR S TN SIO DT 

The RT field designates the valae of the free running 
mlerosecond cloclc {tine since deadstart) nhen the keypeint nas 
executed* On the siffiul ator the clock is lncre«ented by 1 for 
each instruction executed* 

The TSL field designates the time ItRicrosecondsl since the 
last keypoint instruction Mas executed* 

The DATA field specifies the value of the data portion of the 
keypoint in the forwat described in the keypolnt description file 
for this keypoint* 

The CSTR field is the CSTR field frow the keypoint description 
file for this keypoint* 

The S field specifies the state of the machine nhen the 
keypoint Mas issued and is one of the follOMing« 

M ^ Monitor mode 
4 * Job mode 

An * preceding the S field indicates that trap processing 
is active* i*e*^ the trap handler has been entered but 
not exited* 

The TN field gives the global task Id of the task that «as 
exec* 
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F6.0 M^ilIMI-£&QiI£fiyEiS 



P6 . 1 IIllifi.iliM«fiIiliMiII«lMiIiimiI«lifi5il2il 

o Set tlie PPS deadstart panel as f ot lonsi 
CNote that this Is not the settinn for the lOUl 

1 7513 DCN 

2 2001 toe 

3 0000 

4 7713 FNC 

5 0060 CWarmstart readt 556 bf>i# 

unit 01 

6 7413 ACN 

7 7113 IA« 
10 6200 

Set SVIEEP/tOAO/DUNP snitch on the PPS panel to LOAD position. 

o Mount deadstart tape on unit 0* 

Verify that the 512 printer is READY. 

o Depress DEADSTART button at keyi3oard/di spi ay console Cthe 
message "PROCEED* should appear on the left screen). 

o Type SS ffolioMed by a carriage return) to complete system 
initialization. 

F6.2 I2£AfiHMI.MIItlJliliZlIi3 

This deadstart procedure uses the Connon Test and 

Initialization ICTI) facility of NOS/170 to deadstart HOS/VE. It 

requires two tape units# one for the NOS/170 deadstart tape and 
one for the NOS/VE deadstart tape. 

Detailed Information on the use of CTI is located In chapter 2 

Build Hy June 1981 



F6-2 
NOS/VE USERS GUIOE 

07/29/81 

f6.0 DiADSTART PRQCEOURiS 

0f the HOS Version 1 Operators Guide (60433600 il« 
Set tlie deads tart panel as follottss 

1 0000 

2 0000 

3 0000 

4 75TT 

5 77TT 

6 EDOD 

7 74TT 

10 71TT 

11 7301 

12 RPXX 

13 Rf>XX 

14 0000 

TT is the cliannel number of the tape unit containing the 
NOS/170 deadstart tape* 

f is the equipment number of the tape controller* 

ODD is broken dotin as foiloMs< 

FPU 

Ff specifies the type of unit being deadstarted from and Is 
12 for 67X tapes* 26 for 66X tapes and 3U for 844/885 
disks* 

U lor UU) Is the unit number of the device* 

Words 12 and 13 <RPXX) can be ignored as they are only used 
during NOS/170 deadstart* 

Mount the NOS/170 deadstart tape on the unit described by the 

deadstart panel settings* Hount the NOS/VE deadstart tape on 

another unit* Press the deadstart button* The CTI ♦A* 
display should appear* 

Select the U Cutiiities) option* The CTI ♦U^ display should 
appear* 

o Select the A (alternate deadstart! option* CTI mI 1 1 ask for 
the device type* channel* equipment and unit of the device to 
be deadstarted from* The values supplied by the user should 
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1=6.0 OfADSTART PROCEDURES 
f=6.2 OEADSTART WITH NOSflTO 



be tli€ ones for the NOS/VE deadstart tape unit. 

o The message ••PROCEED* stiould appear* Type ••$$•• to start 
NOS/VE. 
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F7.0 ^I31/^I«IISI-£SI1SE1M 



NOS/VE lias a set of progtBrns Mliich run as yser tasks* These 
programs provide the follOMing features! 

- checking specific hardtiare features* 

• checking specific NOS/VE software features* 

• creating a heavy and/or uniform ioad on the system* 

F7*l aiSIilifi-I£SI-.£AS£S 
E7*l.l SORT 



This program creates an array of records with random keyst 
then sorts this array and checks the results* 

The program allows a controlled amount of load to he applied 
to the system paging mechanism* 

syntaxt EX SORT 'NR^RS* 

NR - The number of records to be created and sorted* 

RS - A factor affecting the siaie of each record* By varying 
record sizet the user can change the ratio of CP time to 10 
time for a test* The approximate record size is given by 
the formulat 

32*8*RS 



E7*l*2 USERl 



This program will display the lines 
•user task executing* 
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F7«0 NOS/VE TEST PROSRAHS 
F7,l,2 USERl 



and then terfflinate* It Is used to shOM that tfie system can at 
least execute a very small test case* 

syntax! iX AAAA •STRING* 

STRING -- If this parameter Is present* It nil I be outpiit after 
the vyser task executing* message* 

F7*1.3 UUTt 

This program provides a variety of different test cases* and 
also allONS the« to be run In a repetitive nanner* 

syntax! EX UUTL «STR« 

STR - A string describing which program to run and hoM to run 
it* The various programs are described be I on* 

F7a.3.1 £M2S£££ 

This program generates an environment specification error* 
syntax! EX UUTL «ENVSPEC» 
F7*1.3*2 AMML 

This program generates an arithmetic overflow error* 
syntax! EX UUTt •AROVFl« 
F7. 1.3.3 l!iSS£££ 

This program generates an Instruction specification error* 
syntax! EX UUTt t|HSSPEC« 
F7.1.3.4 MltLl 

This program generates a divide fault error* 
syntax! EX UUTt »OIVFiT* 
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f7,1.3,5 U 

This program performs an lA {load address) instryetion on a 
speeifled PVA« It can be used to test varioys for»s of meiRory 
protection* 

syntax! EX UUTL aAil^VA* 

f>VA - The virtual address to be loaded from* 

F7.1.3.6 Si 

This program performs an SA {store B^diress) Instruction on a 
specified P¥A« It can be used to test various forms of memory 
protection* 

syntaxi EX UUTL •SAtPVA* 

PVA - The virtual address to be stored into. 

F7*1.3*7 mUEfi 

This program modifies the previous stack frame area and then 
returns to see uhat effect the modi fiction mI It have* 

syntaxi EX UUTL «R€TURNfH« 

N * Hodificatlon option* Hust be one of the folloningi 

1 - Set value of A2 so it is not mod 8* 

2 - Set A2 bit 32 to 1* 

3 - Set A2 segment number Invalid* 

4 -* Set A3 segment number to segment Mithout read access* 

5 - Set P register segment number invalid* 

6 - Set 9 register so It is not mod 2* 

7 - Set P register bit 32 to 1* 

8 • Set P register segment number to non executable 

segment* 

9 - Set final AO < > A2* 

10 - Cause VMID error* 

11 - Cause Inmard return* 

12 * Cause return to C170 mode* 
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E7«l,3#0 TESTMEH 



F7.1.3.8 I£lIIS£i 

This program creates# urites «nd verifies an arrajr of 

records* Ttie record size is sucti ttiat sowe records tii 1 1 be 

located on a Mord boundary^ some on all seven CotHerl byte 
boundaries* some Mill cross pages* etc* 

syntaxi EX OUTl •T£ST«EH#BC« 

BC - Nuwber of bytes to be allocated to tbe records* Tbe nywber 
of records created Is* BC OIV I?*!* 

E7.1.3.9 liSIflOJCE 

This program Is similar to TESTHEHt except that 80P 
instructions are used to compare and move records* 

syntaxi EX UUTL »TESTMOVE#BC« 

BC - Number of bytes to be allocated to the records* The number 
of records created Isi BC OIV 255*2 ♦ 1* 

F7,1*3*1C £££y£S£ 

This program calls a procedure recursively* 
syntax! EX UUTL 'RECURSEfN* 

N ' The number of times to recursively call the procedure* 
F7. 1.3*11 £Ki£ 

This program cycles for a specified number of milliseconds* 
It can be used to load the system Mlth *ldle tasks* 

syntax! EX UUTt •CYCLE*HS« 

HS - The number of milliseconds to cycle for* 

E7*l*3.12 Illlifliil 

This program delays for a specified amount of time In 
increments* 
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syntax! EX OUTi «TIM£0UT#T1#T2« 

Tl - The nufRber of tnl i I iseconds In each pflif»$delay reqyest. 

TZ * The total number of milllseoonds delayed* 

F7,1.3,13 imt 

This program loops (executes) for a specified aiRoynt of time* 
It can be used to load the system with active tasks* 

syntax! EX UUTL •LO0P#HS« 

HS ^ The number of milliseconds to execute for. 

F7.1.3.14 AUU 

This prosram creates a segment with read» Mrite» execute and 
binding attrlbutesf places C170 code Into It and executes that 
code* The code executed counts doftn an X resistor and mhtn it 
gets to 2ero# executes an illegal C170 Instruction lop code 
017BI* 

syntax! EX UUTL 'AlTOfN* 

H * This yalue times 1000000 Is placed In the X register being 
decremented to zero* 

F7. 1*3*15 ££££AI 

This program synchronously executes a program a given number 
of times* 

syntax! EX UUTL •R£PEAT#PNfNf «STRJ« 

FN ^ Name of the program to execute* It can be any program 
present in the NOS/VE library* 

N -- The number of times to execute program PH* 

STR - The parameter string passed to the program nhen it begins 
execution* Note the use of double quote marfcs Mithin a 
quoted string* 
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This program Is sinllar to REPiATf but the tasks are run 
asynchf onousiy* 

syntaxt EX UUTt «CAtl.€RfPNfNf •$?«•« 

The parameter definitions are the sawe as REPEAT. 

F7.1.3.17 lillK 

This program runs a nymber of different programs a specified 
number of times* This test is used primarily to load the system 
Kith a random mix of programs* Some programs will terminate 
abnormally* 

syntax! EX UUTL «BUtK»HfX« 

N - The number of times to execute the entire list. The 
foiloMing programs Cuith parameters! are executedi 

L00Pf5 

TIMEOUT* 5 

CYC IE #5 

INSSPEC 

AORSPEC 

ENVSPEC 

PR 1 VINS 

LAf 257800000000116) 

SA#100200000000tl6) 

AROVEL 

X - If this parameter Is specified (any value except 1) then the 
test Kill be run asynchronously * that is# each test In the 
list Mill be started and after they are all running^ the BULK 
test will wait for them all to complete* This procedure Is 
repeated N times* 

If this parameter is not specif! edy or Is specified as 1# each 
test will be allowed to complete before the next test In the 
list Is started* 
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F7.1.3.18 liliEliKI 

This program is siniiar to BULKt except that all of the 
programs run nre expected to complete fiortRally. 

syntaxi EX UUTL «8UtKNTCf H#X« 

N " Same as for BUtK# except the program list is the folloniiigs 

L00P#500 

100P#5 

TIMEOUT#5#500 

CYCtE#500 

R€CURSE#5G00 

LGOPflO 

TEST«EH#100000 

TESTMOViflOOOOO 

L0GP#1000 

X - Same as for BULK. 

F7.1.3.19 AMSE£Q 

This program causes an address specification error* 
syntax? EX UUTL •AORSPEC* 
F7.1.3.20 EEli^lUl 

This program causes a privileged instruction error, 
syntaxi EX UUTL •PRIVINS* 



F7.2 flAMUS 

To run the sort program on 1000 records of size 200 doi 

EX SORT n000f200» 
To run 53 asynchronous copies of same sort test dot 
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fX UOTL •CAilER#SORTf53#»lOO0#2OO«» 

To run th« sawe sort test 45 times in stiocessiorif do 

EX OyTL «R£P£AT#S0RT*45fVl000#20G«« 

HINT! When running rrograas Mhicli nay run for a long period of 
tii»€# use the •*• option on the EX coaiwand. This runs the 
programs asyohronously nith the command processor* This 
altOMS you to status the test to see Mhat is happening 
<TSTATUS# PFSTATSI or to terminate the test if it runs too 
long ITHTERH). 
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61.0 £IIll..M£fiSiIIIJ«l*fi.ifKfi-aiiIS 



Tool 10 CY 

Tool Fl les 

Source PL«s 

PFESRC - Compiler Front End 
PCQSfUCl - CC code generator 
PC6SRC8 - CI code generator 
FAKCHN - €lobal cofliiRon decks 
PIBSRC? - CC run tl«e I ibrary 
iBSRCeO • CI ran tl«e library 



Binary Files 








PFELIB - 


' Compi ler 


Frof 


It End 


PCGLIB7 


- CC 


code 


! generator 


PCGLIB8 


-CI 


code 


! generator 


CYBCOBJ 


- CC 


ryn 


tl«e 


binaries 


CY8I0BJ 


- CI 


run 


time 


binaries 


CYBCtIB 


- CC 


run 


titse 


1 Ibrary 


CYBILIB 


- CI 


run 


tIfRe 


library 


CYBHBIN 


- II 


front end# code generator 


Absol Ut€ 


I Fifes 







and run tine binaries 



CYBIiC - CYBIL-CC compiler 
CYBIil - CY8It-CI cORipller 
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62.0 Slliyia!iI££££££MMM£l£i 



The folionins tools and flies «yst be available for tlie buiici 
process to execute* 

HAOIFY - ASCII version of Modify 

SESULI8 - I/O and fnlscellaneous routines supplied by ttie SES 

project* Found on SES numbered file SESxxxx* 
PRQCIIB - File containing SfS procedure COHPII for building the 

11 front er%4 and code generator* Found In LP3* 
SIHCQBJ - SliRulated NQS/VE Interfaces supplied by the SES 

project* Found on SES numbered file SESxxxx* 
SIHI0B3 - Simulated HOS/VE interfaces supplied by the SES 

project* Found on SES nuiabered file SESxxxx* 
C180 ASSEMBLER - C180 Assembler and SYSTEXT supporting the net* 

object text 
CI 80 QCU - Generate Object Library comioand 
CYBIL-CC - An existing CYBIL-CC coiRplier 
CY8IL-CI - An existing CYBIL-CI compiler 
CYBCCMN * SES cotnmon decks for CYBIL-IO and SES utilities* Found 

on SES numbered file SESxxxx* 
CYBCIHN - SES common decks for SInulated-IO and SES utilities* 

Found on SES numbered file SESxxxx* 
CCCOMPL - Interfaces to the Common Compiler Nodules* 
CCMLIB - Binaries of the Common Compiler Nodules* 
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e3.0 CYBIi COHPIiER BUIIOS 



63.0 £III4^lllf£liIE-JiMlLli5 



This paper describes the procedures recitfired to bylld the 
CYBIL CC» €1 and IX compilers* Ail of the builds %Te adaptable 
to run ill any user catalog* The builds for the CC and CI 
compilers and all of the libraries are Hrltten predominantly in 
CCi Mlth associated usage of S€S procedures* The build for the 
II compiler is an S£S procedure* 

The general approach to building the compilers is first to 
generate an object library for each logical entity of the 
compilers %niSi then for the CC and CI compilers to combine these 
objects into an absolutized compiler* For the II compl lert the 
object libraries %re combined ulth the run time library 
binaries* Hhen the compilers are built for a non-CYBIL project 
catalog# the run-time checking and debug code should be turned 
off* 



G3*l ££Q££IL 

€et file PROCFIL from LP3 and save In the catalog Nhere the 
builds Mill be processed* 

G3*2 £UIi£.££Si:£I2yE£i 

To compile the source PLs# the foliOMing command Is usedi 

SES*00#<«CCL«begin^command«)#def er* 
The format of the CCL.begln.command Isi 

BEGIN#proc.namef PROCFILf src#srcunf i Ibt chk#debug* 

or BEGINfproc.namet PROCFILfsrcf srcunt obJ#chk#debug« 
For building the CI/II library the CCt begln^command 1st 

BEGIN»BCYBIOB»PROCFIt#src#srcun#obJ#chkfdebugfSin/HOWR* 
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63.0 CYBIl COHPItlR BUItOS 
63.2 SUIiO PROCiOURES 



pr oc^ f»a«e - NaiBe of the build procedure# default Is appropriate 
file name as listed In section 1.0. 

src - NaiRe of liadify PL containing the souroet default Is 
appropriate file name listed above. 

srcun • User na«e for srcf default Is tP3. 

lib/obj - Na«e of flie to receive nen object library or object 
filet default as for src. If the file already exists 
it Mill be ovemrl tten# othemise It nil I be 
OEFINEd. For BCYBIOB ulth the HOWR option the file 
naiie «ust be specified If default i«as used Mith the 
Sin option. 

chk - Run-tlflie checking mode for compiler being built# 

default is no checking fCHK»OI» CHK key alone implies 
ail checking options (€HK«HRSI» otherwise specify 
desired CHK parameters. 

debug - Debugging option for compiler being builtj default Is 
no debugs keynord alone implies compile internal 
compiler debug code. 

SIM#HO«R - Parameter for BCYBIOB* SI« specifies that library 
till I be used Kith the CI compilerf HOUR specifies 
that library Mill be used Mith the II compiler. 



AIIOMable CCL.foulld.commands ares 



6E6IN>8I>F£LIB. CComplle front end> 

BFGINfBCYBIOB. CComplle cl libraryl 

B£6IN#BCYBC0B. CComplle cc library> 

B£GIM>BPC6LB7. CComplle cc code generator> 

6FGIN#BPC6LB8. CComplle ci code generator! 

To build a compiler Mith checking mode turned on add the CHK 
parameter. To enable the compiler debug code add the DEBUG 
parameter. 

63.3 £B13U1I 

The SES Proclib must noM be moved from the tP3 catalog to 
access the procedures that complete the compiler builds. 
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S3,0 CYBIl COMPILER BUILDS 

€3.4 BUILD PROCEDURE FOR II COMPILER 



63.4 fiyiii«££fi££fiy£I-£QI-ll.£fll3£li£B 

To conpiie the source PL*Sf ttie following cofRinand Is used 

SES.COHPII l«ods>f obJftyi>e«typun#MfDEE£R. 

wods - wodule names to be complledt for the front endf nods 
would be ABSNE6.«WRITEPRfBISQlO«.PXQQPEN»CY8ILII. 
For the code generator mods would be IBABSRl«.yHSATRf 

obj ^ Name of file to receive new object file. There is no 
default. If the file already exists It will be 
overwritten* otherwise it wl 1 1 be DEFINEd. 

type - specify FE for front end or CG for code generator 

typun * user name for compiler to be used. Default Is LP3. 

03.9 iyiiQ.iuiii£i£liOii 

63.5.1 TO BUILD CYBIL/CC 

SES. 6ENCIL CC. 
€3.5.2 TO BUILD CYBIL/CI 

SES.6ENCIL CI. 
€3.5.3 TO BUILD THE II COMPILER 

SESfSSS.GOF BASE « (FEobJf C6obJ> LIBobJI UPON « CYBHBIH 

feobj - name of the file containing the II compiler front end 

binaries 

cgobj - name of the file containing the II compiler code 

generator binaries 

llbobj * name of the file containing the II run time binaries 
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63*0 CYBIL CG«PIL£i? BUIIDS 

(53*5.4 TO BUIIO CC RUN TIHE LIBRARY 

ACQUIRECCYBC08JI 

ACQUIRE! SESULI8«SeSxxxx/un«SES 

ACQUIRE! SIHC08i«SiSnnnn/un»SiS 

SfS«RERULI8!CYBC0B4fSESULIB»SIHCQB4l NL«CY8CLIB NX«l 

Notci See SES release iianager for actual permanent file 
names SESxxxx 9n4 SESnnnn slionn above* 

G3.5.5 TO BUILD THE CI LIBRARY 

ACQUIRE!CYBI084) 

ACQUIRE!SIMIOBa«SESnnnn/un«SES) 

RETURN! tlbtenp} 

S€S.60L f»!CY8I04B*SIMI0BJ) UR-llbtemp 

SES. REWRITE llbtemp CYBILIB 

Notet See SiS releae manager for actual permanent file names 
SESnnnn s ho tin above* 

Tills library noti includes tlie simulated NQS/VE Interfaces* 

G3*6 lIlI.£i3Mlif£5 

G3*6.1 CC REGRESSION TESTING 



The basic testing for the CC compiler Is the convergence of 
the compiler* 
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€3.0 CYBIi COHritiR BUILDS 

€3.6«2 CI RiSRiSSION TISTIHG 

The test cases exist on file CIBASi/yN»HAII« Conffion deck 
l*ROiQG contains the attacti for the eoaipller to he tested* Coniion 
deck COHPItf contains the compiter call statement and associated 
options* These coAiRon decks should he checked to ensure they are 
setup for the Intended run* 

To suhiiit all the tests dot 

SES.RONCI#«i«<CY001.*CY999lf CLEAR 
After cowpletlon of the execution of the test cases do* 

SiS.RUNANL 
to analyze the results of the regression run* 

63*6*3 II TiSTING 

The current tests to he run are Testl# Test2# Test3f Test4# 
TestL froiB Testpi/un«TaR# TestM and TestN fro* testpl/un«R@D* To 
get the tests from testplf use the MS procedure gencomp* 
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S3,0 CYBIt CONPItCR 8UIL0S 
Hl.l A170 NOS OiADSTART 



Build HIS 
Dtt€t 4/30/81 

The systeiR Is configured to run with three FHO units 141* 

42 and 431* 
o Hount the pack labeled **Advanced Systems Integration €1 

Pack" on any 844 disk drive EXCiPT UNIT 0. 
o Set the 0/S panel to deadstart fron the primary system 

disk* This Is Unit 43 for ail Build H systems, 
o Push D/S button 
o Do an alternate deadstart to tape DUAt6Ni 

- Select "U" display 

- Select «»S» display 

- Deadstart Device Type - 2 ICRI 

- Channel - 13 <CRI 

- Equipment - ICRI 

- Unit - XX ICRI Inhere "xx** is the tape unit nunherl 
Select "O" display 

o Select "H* display 
o Enter CH«10000 
Enter CACHE0-3-0FF 
o Enter ICRI 

o System Mill display the message ^•ENTER LOCATION OF ttSt/HiVS 
DEVICE". Entert 

- Channel - 03 ICRI 

- Efiiulpment - ICR) 

- Unit - XX ICRI Inhere "xx* is the unit number of the 

844 drive nhere the EI pack Is mounted} 
o Enter date/time 

Wait for deadstart to complete. 

Notet The deadstart tape DUAL6N and the EI pack are both found 

In the area In the northeast corner of the room nhere the tape 

cabinet and bookcase of disk packs are found. 
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FHD Unit 43 

This unit contains the follonlngs 

- A170 NOS IBuiid 6 levell* CTI> MSt# EI binariest NOS 
deadstart files 

- Files associated Mith user number LIBRARY 

- Files associated with user number SES 

- Files associated Mith DEVI9 REL1# INTl. 
FMD Unit 41 
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G3.0 CYBIL COHPItfR BUILDS 

HI. 2 CURRENT DUAL STATE C0NFI6URATI0H 



Tfiis is a scratch unit 
FHD Unit 42 

This unit contains the fotlotiingi 

~ HGS/VE Oevelopiient Ara Pi's and Member Pl*s 

- HOS/VE Deadstart Files to be tested f saved In 
individual yser*s catalogsl 

- Files associated with user number INT2 



Hi. 3 ^QUM^HUMUgl 

The foiiOMing file must be available In your catalog on the 
S2t 

TFXXXK contains a NOS/VE deads tart Image* This must be a copy 
of the dual state deadstart Images available from the link 
procedures. CXNA€E# PPIHA&Ef RSXNA6E are "fast*" fllesf Mhlch are 
built from TFXXXfC the first time you deadstart HOS/Vi. These 
files are then used on subsequent deadstart attempts. Before a 
new TPXXXK can be usedf these "fast** files must be purged off 
your user number. 

o Mount the disk labeled "DAHL^-Large sector" on 844 unit 
(other disks will not workl. The default disk driver for 
build N is the NOS/VE driver, 
o Bring up dual statei X.URNYVE ICAT«mycat9 DEVl*scat) where 
mycat « user catalog (as beforel 
scat « system catalog - XNT2 or XNTl (defaults to OEVll 
o The ypNYVE Job will display the foltowingi REQUEST ♦{<♦ 
DISPLAY on the B display Type K#n. where n is the control 
point number of the UPNYVE Job. 



Ml. 4 ^£iM£«y£.£12fi.fi£aflIf.llflSI 

Type 

TAFNVE. 

Control point two must be free or roiloutabie (l.e.» NAN 

should not be there). This also brings up PASSON and the 

NLI subsystem control points. 
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s3,o CYsii cmpiim buiios 

Hl,5 BI^INS OP C180 



HI. 5 ^gglMJkl^ClM 

The folloMing sections use the files af LO or 11 to enter the 
needed coniKands to hrln^ up alt the needed 180 tasks to run 
NGS/VE at this ie¥el. 

If you change any of the foiionlng decks you HUST use the tO 
deadstart fro« your oun catalog (with files CY8ILQ6f XL4QSl# and 
XL4LIBM 

AHHTSA BANOVR BAHPC4 BAHPC2 BAWPCl BA«f>C3 IIHRS€ IIMRtE II«RUH 
IFMEXEC IIWA72H lIHTOit IIMRUSW IIW0C2S OCHREO OCHHUR OCMBIH 
OCHSDi OCHEHO OCHtP OCIICI^Y OCHCRH CICM6EN QCHOnS OCMOEf OCNREP 

ocnoie ocncot ocnobj ochcha ocnsfh ocnaoo ocnnp ochoel qchoib 

OCMCOrf OCMSAT RHHQAE RHLFN RHNQIP RltSENO RHNLOF RHnilLX RHNQOP 
RHNQTE RHNLCF RHTIME RHtO€ RHNGRJ RHHQRE RH88812 RH81288 RHROUTF 
RHMRTlf RHRTRNF RHEETCH RHCETOn USORT UUSERl OUTt 



Hl.5,1 BRING THE SYSTEH UP FOR THE FIRST TIME FROH YOUR CATA106 

Type 

K#n« Mhere n is the UPNYVE control point nu»her« 
K«LIU fyourunfNVEl your^^assword* 
K.€ET»L0fL0#f0£VlfNVE»A6. 
K« INCLUDE L0« 
The systea is up nhen the folloiiing aessage eoiies upt 

SYSTEM IS NOW ALL UP AND RUNNING 

WAITING FOR HOPE INPUT 



Hl.5.2 BRING UP THE INTEGRATION SYSTEN COR YOUR«S AFTER 1ST TIHEI 

The Integration systea has had the LO file ran on It* Also 
the file produced by the LO deadstart have heed aade seal^opyhllc 
and at found on the catalog used In tlie UPNYVE call* 

Type Cwhere DEVI Is the saae as the CAT«¥altte In the UPNYVE 
calDt 

K#n« ahere n Is the UPNYVE control point nuaber* 
K«LIU IDE¥1*NVEI DSVIX* 
K«GET#LlfLl9»»NVE»A6* 
K« INCLUDE LI* 
The systea Is up when the folloulag aessage eoaes upt 
SYSTEN IS NOW ALL UP AND RUNNING 
WAITING FOR NORE INPUT 
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S3,0 CYBIL COHPIifR BUItOS 
HI. 6 NOS/V€ TERMINATION 



Bring ins fiotifi du«l statet 
tC.^BYiVi. 

HI. 7 ^SULIMMUMlflU 

HI. 7.1 TO CREATE AN EXPRESS DEAOSTART DUMP fEODI TAPEi 

Mottnt scratch tape Iring InJ en a 9*traclc drive. 

o Push D/S button. 

Select U futilities) display. 

o Select E (EDO I display. 

Set channel fS2*i3l. 

o Set ECUU CS2«0luul 

E « Equipnent 

C « 1 for 67X drives 
2 for 66X drives 

uu * unit number of the tape drive to be used* 
AnsMer **non zero inhibits renind** with a CR. 
o Answer "dump number*' with a CR. 

o Answer ""dump controlware" with a CR. 

HI. 7. 2 TO CREATE A LISTING OF THE EDO TAPEi 

REQUEST#DUMP#NT>D«PE#F»S»i8«KU#P0«RfVSN«your choice. 

€ET#DS0I#UN«DEV1. lOn S/N 101.1 
or 

€ETfOSOI/UN«OEVl. «0n S2.> 
o Create OSOI directives file* 

A DSDI directive file should include the followingi 

lOOMR. 

PROMR. 

MEMMR. 

PRORE. 

W»f Irst.byte.addressf last^byte«.address^asid. Cwhere the 

f irst.byte^address and I ast.byte.address are hex byte 

addresses and as Id Is the as id of the segment to be 

dumpedl 

or 

\ip f i r s t.by te^addr es s« I as t.by t e^addr ess » s e gment. 
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S3.0 CYBll COHPItER BUILDS 

HI. 7.2 TO CRiATE A IISTIH6 m THE iOO TAPES 



nufliberf«xcti«f)9e.pa€lcage« ExcNange.f^tekage is tt$e RHA of 

ail exchange package or ttie keywords NPS or 4RS. 
Execute OSOIi 

REl» 60000. 

DSOIfHfO#I«'»liip«t directives file". 
To run C after the first tlneM 

OSDI»l«n. 

IDoes not read tape again. I 
To ryfi Inter actively! 

Sane as above* except to do H conwand iiust first dot 

OUTPUTfllSTFIt. 
C170 OSOI information can be found In Chapter 10 of the MQS 
SYSTEN HANTENAHCE Hanyal* A170 DSOX info can be found In 
docunent ARH3060 - 610 for A170 M0S#S2. 



HI • 8 ^Q.MiQifi-£13iSlEQLMMf«£Q£-I«I-lililirl.iliSf •SI£IfiI-iSJ 

The fol toning cowhands need to be entered from deadstart 

o Push D/S button 

Select "O* display 

o Select "$•• display 

o Select TY?E«3 

Select C»«l 

Select CH«l 

o Select EQ«0 

Select UN«43 

o Select "H* display 

o Carriage return 

o Type in "CW MA8 22" carriage return wait until LOADED 

o Then redeadsttrt using section I 



HI. 9 AI2IllIiIUI.II0I£i-ati.IUlU 

o For the use of COL ICREATE.OBiECT.LIBRARYl the follOMing 
180 coauR ends are needed! 

6ET»SYSLIB#SYSLI8»fDEVl»NVEfB56 
6ET,CYBILI8#CY8IIL8#fDEVlfNVEfB56 
SETOL ADD-SYSLIB 

o The above comniands Mill be needed for all utilities other 
then CITOII. 
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